PART VII 
XVM/RSX ON-LINE TASK DEVELOPMENT 



CHAPTER 1 
INTRODUCTION TO MULTIACCESS 



1.1 FUNCTION OF TASK DEVELOPMENT 

RSX has the capability of multiuser on-line task development with 
concurrent batch processing. Multiuser task development (TDV) is 
known as the MULTIACCESS facility. RSX offers a full range of TDV 
functions under control of the MULTIACCESS Monitor. By calling 
different TDV system modules (function tasks) supplied with RSX, the 
user can enter or change source code, compile a FORTRAN IV program or 
assemble a MACRO program, and build this program as a task that will 
execute under RSX control. (In addition, the user can invoke utility 
routines to perform a variety of file listing and maintenance 
functions.) The TDV function tasks supplied as part of RSX are listed 
in Table 1-1. 

Besides the TDV function tasks, the MULTIACCESS Monitor supports a set 
of commands that control the user TDV environment. The MULTIACCESS 
Monitor commands are listed in Table 1-2. Furthermore, three 
control-character facilities have been provided to help the user 
control his particular task development. The MULTIACCESS 
control-character facilities are listed in Table 1-3. 

JOB, BAT and END (not listed in Table 1-1) are classified as TDV 
functions, but because they have meaning only when batch processing, 
they are separtely described in Part VIII of this manual. 

Another TDV function task (not listed in Table 1-1) , PUP (Peripheral 
Utility Program) , resembles pip (Peripheral Interchange Program) , 
which is used on other systems. PUP enables the user to transfer 
files from one device to another. Although it is not supplied with 
RSX, the user can obtain it from the DEC User Society (DECUS) . 

The MULTIACCESS facility can be used from any number of terminals up 
to the maximum number supported by the particular system 
configuration. However, for most installations, the number of 
terminals used simultaneously for task development should be limited 
to six. This is suggested because of the large size of several 
critical TDV function tasks. 
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Table 1-1 
TDV Function Tasks 






TDV Function Task 



FOR[TRAN] 

MAC[RO] 

EDI [TOR] 

SLI[P] 

TKB[UILDER] 

BTK 

FIN [PUT] 

DEC[K] 

FOU[TPUT] 

LIS[T] 

TYP[E] 

DEL[ETE] 

REN[AME] 

DIR[ECTORY LIST] 

DTD[IRECTORY] 

NEW [DIRECTORY] 

INS [TALL]* 

REQlUEST]* 

REM[OVE]* 

MNT* 

DSM* 

CON [STRUCT] 

STA[TUS] 

QUE[UE] 

ODT 

ACI 

ACD 



Function Performed 



Compile a FORTRAN IV program 

Assemble a MACRO program 

Text-edit source code 

Edit batch files 

Build a task for execution 

Basic Task Builder 

Transfer a sequential file to disk 

Batch transfer to disk 

Transfer a sequential file from disk 

Transfer a sequential file from disk 
to printing device 

Transfer a sequential file from disk 
to printing device 

Delete file from disk 

Rename file stored on disk 

List files in file directory on disk 

List DECtape file directory 

Write out a new DECtape file directory 

Install a task in the system 

Request task execution 

Remove a task from the system 

Logically mount a disk 

Logically dismount a disk 

Store a task on a user disk 

Print MULTIACCESS Monitor statictics 

Queue a batch job 

Octal Debugging Technique 

Initialize batch account file 

Display batch account file 



I *Not recommended for use under MULTIACCESS 
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Table 1-2 
MULTIACCESS Monitor Commands 



Command 


Function Performed 


OFF 

DEV[ICES] 

PAR[TITION] 
KPAR[TITION] 
ASG (ASSIGN) 

XQT 


Log the user off of the MULTIACCESS 
system 

Print the user's LUN-to-device 
relationship 

Specify the user's memory requirements 

Specify the user's memory requirements 

Assign the user's LUNs to peripheral 
devices 

Execute a user task 



Table 1-3 
MULTIACCESS Control-Character Facilities 



Control Character 


Function Performed 


CTRL/T 

CTRL/Y 
CTRL/P 


Begin the login process, if the user 
is not logged in. 

Inform the user of his current job 
status, if the user is logged in. 

Abort the user's current task (TDV 
function or user-written task) , if one 
is active. 

Resume a user task if it has been 
suspended by a FORTRAN PAUSE statement 
or MACRO SUSPEND directive. 
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All TDV function tasks are invoked through the MULTIACCESS Monitor, an 
exec-mode task that is built for any user-specified partition within 
the first 32K of core. TDV function tasks, such as the FORTRAN IV 
Compiler, reside on the disk until requested by the Resident TDV 
Dispatcher. These tasks typically share a core partition, although 
they can be built to run in any partition. 

To facilitate concurrent operations, it is necessary to assign virtual 
user LUNs in such a way that devices need not be reassigned when the 
user switches from one TDV function to another. Table 1-4 contains 
recommended virtual LUN assignments for TDV use. Device names 
correspond to devices listed in Table 1-5. Function names are given 
in Table 1-1. 



NOTE 

Thoughout this part of the manual and 
wherever user LUNs are referred to, it 
must be understood that these are 
virtual LUNs. Virtual LUNs are 
automatically "mapped" to system LUNs by 
the MULTIACCESS Monitor. 

The MULTIACCESS Monitor accepts requests for specific functions as 
input from a dynamically allocated system LUN. The resident task then 
requests that a specific TDV function task be brought into its core 
partition from disk. This function task assumes control and can 
perform the jobs described in subsequent chapters. 

TDV function tasks accept command input from LUN-12, in much the same 
way as the Resident MCR accepts requests for MCR functions from LUN-2. 
TDV error messages are sent to LUN-13 just as MCR error messages are 
sent to LUN-3. The MULTIACCESS user should leave virtual LUNs 12 and 
13 assigned to TT (the default assignment) . 

Actual time of execution of TDV function tasks, like user tasks, 
depends on partition availability and task priority. More detailed 
descriptions of this process appear below and in Part XI of this 
manual . 
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Table 1-4 
TDV Virtual LUN Assignments 

11 



12 



13 



14 



15 



16 



17 



18 



19 



20 



21 



DK 


RF, 
RP or 
RK 


RF, 
RP or 
RK 


RF, 
RP or 
RK 


TT 


TT 




RF, 
RP or 
RK 


LP 


RF, 
RP or 
RK 


RF, 
RP or 
RK 


DT 


TT 


TT 










TDV 
cmd 
in 


TDV 
err 
log 


























FOR 
cmd 
in 


FOR 
err 
msgs 




FOR 
SRC 
in 


FOR 
list 


FOR 
BIN 
out 


















MAC 
cmd 
in 


MAC 
err 
msgs 




MAC 
SRC 
in 


MAC 
list 


MAC 
BIN 
out 


MAC 
sec 
in 




MAC 
aux 
in 












EDI 
cmd 
in 


EDI 
err 
msgs 






EDI 
aux 
out 


EDI 
SRC 
I/O 


EDI 

temp 

file 




EDI 
aux 
in 


EDI 

terra 

I/O 






TKB 
sys 
libr 


TKB 

user 

libr 


TKB 
cmd 
in 


TKB 

term 

out 








TKB 
BIN 
in 


TKB 
TSK 
out 
















FIN 
cmd 
in 


FIN 
err 
msgs 








FIN 

file 

out 




FIN 

file 

in 














FOU 
cmd 

in 


FOU 
err 
msgs 








FOU 

file 

in 




FOU 

file 

out 














LIS 
cmd 
in 


LIS 
err 
msgs 






LIS 
list 


LIS 

file 

in 


















DEL 
cmd 
in 


DEL 
err 
msgs 








DEL 

file 

I/O 


















REN 
cmd 
in 


REN 
err 
msgs 








REN 

file 

I/O 










DIR 
dsk 
drvr 








DIR 
cmd 
in 


DIR 
err 
msgs 






DIR 
list 













(Continued) 



Table 1-4 (Cont.) 
TDV Virtual LUN Assignments 



LUN 



I 



en 

(D 

■O 
ft 
<D 

(D 



1 


5 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 










DTD 
cmd 
in 


DTD 

err, 

list 












DTD 

tape 

in 














NEW 
cmd 
in 


NEW 
err 
msgs 












NEW 

tape 

out 








INS 
TSK 
in 






INS 
cmd 
in 


INS 
err 
msgs 


























REQ 
cmd 
in 


REQ 
err 
msgs 


























REM 
cmd 
in 


REM 
err 
msgs 


























MNT 
cmd 
in 


MNT 

err 
msgs 


























DSM 
cmd 
in 


DSM 
err 
msgs 


























XQT 

cmd 
in 


XQT 
err 
msgs 




















CON 
TSK 
in 






CON 
cmd 
in 


CON 
err 

msgs 


























DEC 
cmd 
in 


DEC 
err 
msgs 


DFC 

file 

in 






DEC 

file 

out 






. ■ .- . 1 





vo 



Table 1-5 
I/O Devices 



Device Name 



TTn 

DTn 

MTn 

RF 

RPn 

RKn 

PR 

PP 

CD 

CP 

LP 

AD 

AF 

UD 

CC 

VTn 

VWn 

XY 

CD 



Device 



Terminal 

DEC tape 

Magtape 

Fixed-Head Disk 

Disk Pack 

Disk Cartridge 

Paper Tape Reader 

Paper Tape Punch 

Card Reader 

Card Punch 

Line Printer 

Analog- to-Digital Converter 

Automatic Flying Capacitor Scanner 

Universal Digital Controller 

System COMMON Communicator 

Display 

Writing Tablet 

XY Plotter 

Card Reader (CRll) 
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1.2 REQUESTING THE RESIDENT TDV DISPATCHER 

Task development can be requested from any idle terminal by typing 
CTRL/T. This usually causes the LOGIN Processor to be invoked. 
CTRL/T is ignored, however, if the terminal is ATTACHed or if the 
Resident TDV Dispatcher cannot execute for any reason (e.g., if it has 
not been INSTALLed, if it is DISABLEd or if its partition is in use) . 

If the user is already logged into MULTIACCESS, CTRL/T causes the 
status of the current function to be printed. The format of this 
status message is: 

TASKNME PARTITION ATL STATUS ABBREVIATION 

where TASKNAME is the name of the user program or system function, 
PARTITION is the name of the partition in which the task is running 
and ATL STATUS ABBREVIATION is one of the following: 

ATL Status Abbreviation Meaning 

CREATING TASK Task is not yet active 

WAITING FOR PARTITION 

ON DISK ATL Status 1 or 2 

WAITING AT (address) ATL status 3 (restart address is printed 

after the abbreviation) 

EXECUTING ATL Status 4,5,7 or 10 

SUSPENDED ATL status 6 (equivalent to PAUSE in 

FORTRAN) 

ABORTING 
SYSTEM ERROR- 
TASK NOT IN ATL 

If no user-specified task is running (i.e., if the Resident TDV 
Dispatcher is waiting for the user to enter a command) , the following 
message is printed: 

TDV AWAITING COMMAND 
TDV> 

If the user is not logged into MULTIACCESS, the LOGIN Processor 
determines whether there are sufficient resources available to log the 
user into the system. If resources are not available, the LOGIN 
Processor prints the message: 

MULTIACCESS - TOO MANY JOBS 

on the terminal and ignores any user-typed commands until CTRL/T is 
typed again. If resources are available, the LOGIN Processor logs in 
the user and prints the message: 

XVM/RSX VIBOOO MULTIACCESS 

MONTH/DAY/YEAR HOUR: MINUTE 
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NN USERS LOGGED IN 

SPECIFY DISK TYPE (RK, RP OR RF) , UNIT AND UFD> 

The user must then respond by typing the requested data in 
following format: 



the 



B i"-'l" 



<UFD> 



(e.g., RK5 <XYZ>) 



The default disk type is the same as that of the system disk, the 
default unit number is and the default UFD is <SCR>. 

If the user does not complete the response with a line terminator 
within 60 seconds, the LOGIN Processor returns the terminal to the 
Idle state. If the UFD specified does not exist for the disk 
specified, the LOGIN Processor creates it. In this event, the LOGIN 
Processor informs the user by printing the message: 

UFD CREATED: <UFD> 

During the login process, user errors cause the following messages to 
be printed: ' 



Error Message 

NONEXISTANT UNIT NUMBER 
RETYPE > 

SYNTAX ERROR 
RETYPE > 

UFD CREATION ERROR 



SYSTEM ERROR- 
MISSING PDVL NODE 



Cause 



The unit 
exist. 

The command 
error. 



number specified does not 
line contains a syntax 



A new UFD was specified and disk errors 
prevented its creation. This is a fatal 
error. 

This is a fatal error. 



Fatal errors cause an automatic logoff to occur. 

Once the user has successfully logged into MULTIACCESS, the system 
responds by printing the prompter: 

TDV> 

in response to this prompter, the user can enter any legal tdv 
command . 



1.3 TDV/SYSTEM COMMUNICATION 

Consider the following command line as an example of invoking the 
FORTRAN IV compiler: •vuR.xny cne 

TDV>FOR BPROGl 

In RSX, both the command to run the Compiler and the command to the 
Compiler itself are typed on the same line. 
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when the Compiler is loaded into core and begins to run, it issues a 
system directive called XFRCMD, which causes the line read by the 
Resident TDV Dispatcher to be transferred to the Compiler. This is a 
command used by all TDV function tasks regardless of whether or not 
they request any command input. Until XFRCMD is issued, the Resident 
TDV Dispatcher command line buffer is occupied. 

Once the command line is transferred and the requested task has 
completed its operation, the Resident TDV Dispatcher task is 
automatically requested by the TDV function task (the FORTRAN Compiler 
in this example) • Alternatively, the user can abort the current user 
task and invoke the Resident TDV Dispatcher by typing CTRL/Y. 



1.4 TDV COMMAND CONVENTIONS 

Requests for individual TDV function tasks are entered according to 
the following conventions: 

1. Command strings are terminated by either a carriage return or 
an altmode. These terminators are treated identically by 
MULTIACCESS. 

2. Each element of the command string must be separated by 
either a comma, a space or a back arrow, as appropriate. 

3. Any number of characters (except a comma or space) can be 
inserted between a TDV function task name and its arguments 
or command-string terminator (carriage return or altmode) . 
This facility is useful for improving the readability of 
teleprinter copy. For example, the following two commands 
illustrate the abbreviated and the more readable way of 
calling the Editor: 

TDV>EDI 

or 

TDV>EDITOR 

4. If the user discovers an error in the command string before 
the terminator has been typed, the line can be deleted as far 
back as the prompting character (>) by typing a single 
CTRL/U. An "at" symbol (@) is echoed, informing the user 
that he can now retype the command string. Rubout, echoed as 
a backslash (\) , can be used to delete characters one by one, 
starting with the last character typed. 



1.5 TDV FUNCTION TASKS 

Each of the following chapters describes one TDV function task. In 
all models and examples included in these chapters, the following 
conventions apply: 



XVM/RSX VIB VII- 1-9 September 1976 



1. A space in the text indicates an actual space in the command 
line. 

2. -(-indicates an actual backward arrow in the command line. 

3. V indicates a terminator. This can be either a carriage 
return or an altmode. 

4. Square brackets ([,...]) indicate optional characters. 

5. Optional items that can be repeated are indicated by dots 
following the item in square brackets. If a comma precedes 
these dots ([...]), only the last parameter can be repeated. 
Repetitions must be separated by commas. Therefore, in: 

FIN[9] [option] name [ext] [,...] 

at least one name with an optional extension must be 
specified. Additional file names, each with an optional 
extension, can be included, as in: 

TDV>FIN F1,F2,F3 

TDV>FIN Fl SRC,F2 BIN 

TDV>FIN F1,F2 SRC 

6. In "form" models, upper-case characters (except LUN) indicate 
those required by the system. Lower-case characters indicate 
entries that are to be specified by the user and are 
dependent on his particular task. 

7. All LUNs requested are virtual LUNs. 

8. Braces (j|) enclosing a stack of items indicate that one item 
in the stack must be selected. 

Five TDV functions described in the following chapters are not 
recommended for use under MULTACCESS. They are: 

INSTALL 

REQUEST 

REMOVE 

MOUNT 

DISMOUNT 

They can be included in the system (via atypical system-build 
procedures) , but only to maintain compatibility with existing user 
batch streams. 
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CHAPTER 2 
FORTRAN: COMPILING A FORTRAN PROGRAM 



The FORTRAN TDV Function Task invokes the FORTRAN IV Compiler. This 
Compiler is a two-pass system program that produces relocatable object 
code. The Task Builder (TKB) then links this code with required 
Object-Time System (OTS) library routines and optionally with 
additional user-specified FORTRAN-compiled or MACRO-assembled 
routines . 

Systems with a Floating-Point Processor (FPP) have a special version 
of the FORTRAN IV Compiler and OTS which utilizes hardware 
instructions rather than software calls. For example, RELEAE, the 
REAL arithmetic package, is not included in FPP systems since REAL 
arithmetic expressions are evaluated with the aid of hardware 
instructions. The FPP FORTRAN System consists of the standard FORTRAN 
IV Compiler and Object-Time System interfaced (via conditional 
assembly and additional routines) to the hardware FPP (Floating-Point 
Processor) . The interface applies to single and double precision 
floating-point arithmetic and extended integer arithmetic (double 
integers) . Single integer arithmetic is still handled, in part, by 
software. Installations with a Floating-Point Compiler should delete 
FOR... and rename F4F... as FOR. ,, . 

The FORTRAN Compiler can also be invoked in batch mode. 



2.1 INVOKING THE FORTRAN IV COMPILER 

The user can invoke the FORTRAN IV Compiler by typing a command 
according to the following format: 
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Form: 


POR[TRAN] [ option (,]...] -^name [ ,name, . . ] V 


Where: 


option is a one-character symbol specifying a 
compilation option (see Table 2-1); option 
characters may be either concatenated or 
separated by commas 

name of program to be compiled is a string of 
one to six .SIXBT characters; at least one 
neune is required, but several programs may 
be compiled in sequence to produce separate 
binary files 


Excunple: 


Compile program neuned PROG, creating a binary 

file (B) and a listing (L) ; 
TDV>POR BL<-PROG 



Table 2-1 illustrates all compiler options available under RSX. 
number of these may be concatenated in a TDV command string. 



Any 



Table 2-1 
FORTRAN IV Compiler Options 



Option 


Action 


Default 


B 

H 

L 

S 
R 


Binary output 

Use subroutine .SS 
to generate addresses 
of two- and three- 
dimensional eurray 
elements 

Source listing 

Object listing 

Symbol map 

Print Compiler ver- 
sion number emd END 
PASSl on output 
terminal 


No binary file 

Use in-line code to 
generate array element 
addresses (except for 
I/O pareuneter list 
elements ) 

No listing 

No listing 

No symbol map 

No printout 
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2 . 2 INPUT/OUTPUT 

The following LUN assignments should be made before the FORTRAN IV 
Compiler is invoked under MULTIACCESS: | 

LUN Assignment 

13 Error messages (terminal recommended) 

15 Source file input 

16 Listing output 

17 Binary file output 

If an I/O error occurs during compilation, the message: 

FOR- I/O ERROR LUN xx yyyyyy 

is produced on LUN-13. In this message, xx represents the logical 
unit number (decimal) and yyyyyy represents the event variable value 
(octal), indicating the cause of the error. 

2.3 COMPARISON WITH OTHER VERSIONS OF FORTRAN 

The FORTRAN IV language employed under XVM/RSX is basically the same 
as that used under the XVM/DOS system- It differs, however, from the 
versions of the Compiler used in support of previous versions of RSX. 
All user FORTRAN programs developed under previous versions of RSX 
must be recompiled and rebuilt by the Task Builder to enable them to 
run under XVM/RSX. 

The basic language and operating conventions of XVM/RSX FORTRAN are 
described in the FORTRAN IV XVM Language Manual and FORTRAN IV XVM 
Operating Environment Manual. Nevertheless, RSX user interaction with 
FORTRAN IV differs in some ways from the descriptions in those 
manuals. The main differences occur in support of the auxiliary disk, 
input/output, the STOP and PAUSE statements, the floating-point 
processor, OTS output and table initialization. These differences are 
described in more detail below. Differences in methods for opening, 
closing, deleting and renaming files are described in Part VI of this 
manual . 



2.3.1 Auxiliary Disk 

FORTRAN IV under RSX supports all standard FORTRAN features, except 
certain i magtape and auxiliary disk I/O functions (e.g., REWIND, 
BACKSPACE, etc.) . 
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2.3.2 Input/Output 

The Input Command Decoder of the Compiler has been modified to use 
standard task development function input and to compile multiple files 
with the same switches. For example: 

FOR BLFILE1,FILE2 

causes the FORTRAN IV Compiler to compile programs FILEl and FILE2 in 
sequence and to produce separate binary files and listings. 

More specifically, RSX random-access I/O to the disk differs slightly 
from the description in the manuals listed above. The description of 
disk I/O in Part VI of this manual gives details on random-access I/O 



2.3.3 STOP and PAUSE Statements 

FORTRAN IV STOP and PAUSE statements call library routines that have 
been slightly modified for RSX use. A STOP message prints on the 
terminal only if nonzero arguments are present; otherwise, the task 
simply exits. PAUSE produces a new message that includes the task 
name. To continue after a PAUSE, the user can type a CTRL/P or the 
operator can use the RESUME MCR Function Task. 



2.3.4 Floating-Point Processor 

Under RSX, the JEA register for the floating-point processor (FPP) is 
initialized by the SETJEA system directive. If the system has not 
been configured for FPP hardware, an unrecoverable .OTS 52 error is 
output. 



2.3.5 OTS Output 

Output from the FORTRAN object- time system, such as .OTS errors and 
STOP and PAUSE messages, goes to LUN-4, typically assigned to the user 
TDV terminal, except when the system is batch processing. When 
FORTRAN ]obs are run under MCR, LUN-4 is typically assigned to the MCR 
terminal. 



2.3.6 Table Initialization 

Under RSX, the I/O Table Initialization Routine (.FP) has been removed 
from FIOPS and now exists as a separate routine. This implementation 
prevents unnecessary loading of FIOPS when no I/O capability is 
required. ^ 
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2.4 ERROR MESSAGES 

Tables 2-2, 2-3, and 2-4 list possible error messages and their 
implications. All messages in Table 2-2 are printed in the following 
form: 



Form: 



>mA< 



Where : 



m is the error number 

A is the alphabetic mnemonic characterizing the 
error class 



Table 2-2 
FORTRAN Error Messages 



Number 


Letter 


Meaning 






Common, equivalence, data errors; 


01 


C 


No open parenthesis after variable name 
in DIMENSION statement 


02 


C 


No slash after COMMON block naune 


03 


C 


COMMON Block name previously defined 


04 


C 


Variable appears twice in COMMON 


05 


C 


EQUIVALENCE list does not begin with 
open parenthesis 


06 


C 


Only one variable in EQUIVAT.RNCE class 


07 


c 


EQUIVALENCE distorts COMMON 


08 


c 


EQUIVAT.RNCE extends COMMON down 


09 


c 


Inconsistent equivalencing 


10 


c 


EQUIVALENCE extends COMMON down 


11 


c 


Illegal delimiter in EQUIVALENCE list 


12 


c 


Non-COMMON variables in BLOCK DATA 


15 


c 


Illegal repeat factor in DATA statement 


16 


c 


DATA statement stores in COMMON in 
non-BLOCK DATA statement or in 
non-COMMON in BLOCK DATA statement 



(Continued on next page) 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 


Letter 


Meaning 






DO errors: 


01 


D 


Statement with unparenthesized = sign 
and comma not a DO statement 


04 


D 


DO variable not followed by = sign 


05 


D 


DO variable not integer 


06 


D 


Initial value of DO variable not 
followed by comma 


07 


D 


Improper delimiter in DO statement 


09 


D 


Illegal terminating statement for DO 
loop 

External symbol and entry-point 
errors : 


01 


E 


Variable in EXTERNAL statement not 
simple non-COMMON variable or simple 
dummy variable 


02 


E 


ENTRY name non-unique 


03 


E 


ENTRY statement in main program 


04 


E 


No = sign following argument list in 
arithmetic statement function 


05 


E 


No argument list in FUNCTION subprogram 


06 


E 


Subroutine list in CALL statement 
already defined as varieible 


08 


E 


Function or array ncune used in 
expression without open parenthesis 


09 


E 


Function or array name used in 
expression without open parenthesis 

Format errors: 


01 


F 


Bad delimiter after FORMAT number in I/O 
statement 


02 


F 


Missing field width, illegal character 
or unwanted repeat factor 



(Continued on next page) 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 


Letter 


Meaning 


03 


F 


Field width is 


04 


F 


Period expected, not found 


05 


F 


Period found, not expected 


06 


F 


Decimal length missing (no "d" in 
"Fw.d") 


07 


F 


Missing left parenthesis 


08 


F 


Minus without number 


09 


F 


No P after negative number 


10 


F 


No number before P 


12 


F 


No number or before H 


13 


F 


No number or before X 


15 


F 


Too many left parentheses 
Hollerith errors; 


02 


H 


More than two characters in Integer or 
Logical Hollerith constant 


03 


H 


Nvunber preceding H not between 1 and 5 


04 


H 


Carriage return inside Hollerith field 


05 


H 


Number preceding H not an integer 


06 


H 


More than five characters inside quotes 


07 


H 


Carriage return inside quotes 
Various illegal errors: 


01 


I 


Unidentifiable statement 


02 


I 


Misspelled statement 


03 


I 


Statement out of order 


04 


I 


Executable statement in BLOCK DATA 
subroutine 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 


Letter 


Meaning 


05 


I 


Illegal character in I/O statement, 
following xinit number 


06 


I 


Illegal delimiter in ASSIGN statement 


07 


I 


Illegal delimiter in ASSIGN statement 


08 


I 


Illegal type in IMPLICIT statement 


09 


I 


Logical IF as target of logical IF 


10 


I 


RETURN statement in main program 


11 


I 


Semicolon in COMMON statement outside of 
BLOCK DATA 


12 


I 


Illegal delimiter in IMPLICIT statement 


13 


I 


Misspelled REAL or READ statement 


14 


I 


Misspelled END or ENDFILE statement 


15 


I 


Misspelled ENDFILE statement 


16 


I 


Statement function out of order or 
undimensioned array 


17 


I 


Typed FUNCTION statement out of order 


18 


I 


Illegal character in context 


19 


I 


Illegal logical or relational operator 


20 


I 


Illegal letter in IMPLICIT statement 


21 


I 


Illegal letter range in IMPLICIT 
statement 


22 


I 


Illegal delimiter in letter section of 
IMPLICIT statement 


23 


I 


Illegal character in context 


24 


I 


Illegal comma in GOTO statement 


26 


I 


Illegal variable used in multiple RETURN 
statement 



(Continued on next page) 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 



01 
02 

03 

04 



08 
09 
10 

01 

02 
03 



Letter 



L 
L 

L 

L 



01 


M 


02 


M 


03 


M 


04 


M 


06 


M 


07 


M 



M 

M 
M 

N 

N 
N 



Mecining 



Pushdown list errors: 
DO nesting too deep 
Illegal DO nesting 

Subscript/function nesting too deep 

Incomplete DO loop-caused by backwards 
DO loop, error in DO loop foot state- 
ment, or error in I/O statement with 
implied DO loop 

Overflow errors: 

EQUIVALENCE class list full 

Progrcun size exceeds 8K 

Local array length larger than 8K 

Element position in local array larger 
than 8K or in common array larger than 
32K (EQUIVALENCE, DATA) 

Integer negative or larger than 131071 

Exponent of floating point number Icirger 
than 76 

Overflow accumulating constant - too 
many digits 

Overflow accumulating constant - too 
many digits 

Overflow accumulating constant - too 
many digits 

Statement number errors: 

Multiply defined statement number or 
compiler error 

Statement erroneously labeled 

Undefined statement number 



(Continued on next page) 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 



04 

05 
07 
08 
09 

01 
02 
03 
04 

05 

01 

02 
03 

04 
05 
06 
10 
11 
12 



Letter 



N 
N 
N 
N 

P 
P 
P 
P 



S 

S 

S 

s 
s 
s 
s 
s 



Meaning 



FORMAT 
number 



statement without statement 



Statement number expected, not found 

Statement number more them five digits 

Illegal statement number 

Invalid statement label or continuation 

Partword errors: 

Expected colon, found none 

Expected close bracket, found none 

Last bit number larger than 35 

First bit number larger than last bit 
number 

First cuid last bit numbers not simple 
integer constants 

Subscripting errors: 

Illegal subscript delimiter in 
specification statements 

More than three subscripts specified 

Illegal delimiter in subroutine argument 
list 

Non-integer subscript 

Non-scalar subscript 

Integer scalar expected, not found 

Two operators in a row 

Close parenthesis following an operator 

Adjustable dimension not in dummy array 



(Continued on next page) 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 



13 
14 
15 

16 



01 
02 
03 

01 



07 

08 

09 
11 

12 



02 


V 


03 


V 


03 


V 


05 


V 



Letter 



S 
S 
S 



T 



V 

V 
V 



Meaning 



Adjustable dimension not a dummy integer 
Two arguments in a row 

Digit or letter encountered after 
argument conversion 

Number of subscripts stated not equal to 
number declared 

Table overflow errors: 

Arithmetic statement, computed GOTO 
list, or DATA statement list too large 

Too many dummy variables in eurithmetic 
statement function 

Symbol and constant tables overlap 

Variable errors: 

Two modes specified for same variable 
ncune 

Variable expected, not found 

Constant expected, not found 

Array defined twice 

Error: variable is EXTERNAL or argument 
(EQUIVALENCE, DATA) 

More than one dimension indicated for 
scalar varieible 

First character after READ or WRITE not 
open parenthesis in I/O statement 

Illegal constant in DATA statement 

Variables outnumber consteuits in DATA 
statement 

Constants outnumber varicdiles in DATA 
statement 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 



14 



16 



17 


V 


19 


V 


21 


V 


22 


V 


25 


V 


27 


V 


28 


V 


29 


V 


30 


V 


32 


V 


35 


V 


36 


V 



37 



38 



39 



40 



Letter 



Meaning 



Illegal dummy varicible (previously used 
as non-dummy variable) 

Logical operator has non- integer, 
non- logical arguments 

Illegal mixed mode expression 

Logical operator has non-integer, 
non- logical arguments 

Signed variable left of = sign 

Illegal combination for exponentiation 

.NOT. operator has non-integer, 
non- logical argument 

Fvmction in specification statement 

Two exponents in one constant 

Illegal redefinition of a scalar as a 
function 

No number after E or D in a constant 

Non-integer record number in 
random-access I/O 

Illegal delimiter in I/O statement 

Illegal syntax in READ, WRITE, ENCODE, 
or DECODE statement 

END or ERR exists out of order in I/O 
statement 

Constant and varicible modes don't match 
in DATA statement 

ENCODE or DECODE not followed by open 
parenthesis 



Illegal delimiter 
statement 



in ENCODE/DECODE 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 


Letter 


Meaning 


41 


V 


Array expected as first argument of 
ENCODE/DECODE Statement 


42 


V 


Illegal delimiter in ENCODE/DECODE 
statement 

Expression errors; 


01 


X 


Carriage return expected, not found 


02 


X 


Binary WRITE statement with no I/O list 


03 


X 


Illegal element in I/O list 


04 


X 


Illegal statement number list in 
computed or assigned GOTO 


05 


X 


Illegal delimiter in computed GOTO 


07 


X 


Illegal computed GOTO statement 


10 


X 


Illegal delimiter in DATA statement 


11 


X 


No close parenthesis in IF statement 


12 


X 


Illegal delimiter in arithmetic IF 
statement 


13 


X 


Illegal delimiter in arithmetic IF 
statement 


14 


X 


Expression on left of = sign in 
arithmetic statement 


15 


X 


Unequal number of right and left parentheses 


16 


X 


Illegal open parenthesis (in 
specification statements) 


17 


X 


Illegal open parenthesis 


19 


X 


Unequal number of right and left parentheses 


20 


X 


Illegal alphabetic in numeric constant 


21 


X 


Symbol contains more than six characters 
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Table 2-2 (Cont.) 
FORTRAN Error Messages 



Number 


Letter 


Meaning 


22 


X 


•TRUE., .FALSE., or .NOT, preceded by 
an argument 


23 


X 


Unparenthesized comma in arithmetic 
expression 


24 


X 


Unary minus in I/O list 


26 


X 


Illegal delimiter in I/O list 


27 


X 


Unterminated implied-DO loop in I/O list 


28 


X 


Illegal = sign in I/O list 


29 


X 


Illegal partword operator 


30 


X 


Illegal arithmetic expression 


31 


X 


Illegal operator sequence 


32 


X 


Illegal use of = sign 


33 


X 


Missing parenthesis in I/O statement 
with implied DO loop will also cause 
>041< 


34 


X 


Extraneous characters at the end of 
assignment statement 
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In Table 2-3, (R) indicates a recoverable error and (T) indicates a 
terminal error. 



Table 2-3 
OTS Error Messages 



Number 



05 (R) 

06 (R) 

07 (R) 

10 (T) 

11 (T) 

12 (T) 

13 (T) 

14 (R) 

15 (R) 

16 (R) 

17 (R) 
20 (T) 



21 (T) 

22 (T) 

23 (T) 

24 (T) 

25 (T) 



Possible Source 



SQRT 
DSQRT 

.GO 

.FR, .FW, .FS, .FX, 
DEFINE, RANCOM 

•FR, .FA, .FE, .FF, 
.FS, RANCOM, 
RBINIO, RBCDIO 

.FA, .FE, .FF 

.BC, .BE, ALOG 



.BD, .BF, .BG, .BH, 
DLOG, DLOGIO 

.BB, .BC, .BD, .BE, 
. BF , « BG , . BH 

ATAN2 



Meaning 



DATAN2 



FIOPS, AUXIO, RANCOM 



Negative REAL square-root argument 

Negative DOUBLE PRECISION square-root 
argument 

Illegal index in computed GOTO 
Illegal I/O device number 

Bad input data - lOPS mode incorrect 



Bad FORMAT 

Negative or zero REAL logarithmic 
argument (terminal) 

Negative or zero DOUBLE PRECISION 
logarithmic argument 

Zero raised to a zero or negative 
power (zero result is passed) 



ATAN2 (0.0,0.0) 
returned 



attempted Pl/2 



21 to 26 are 
RANCOM 
DEFINE 
RANCOM 
DEFINE, RANCOM 

RANCOM 



DATAN2 (O.ODO, O.ODO) attempted Pl/2 
returned 

Fatal I/O error (RSX only) . 
The message format is 
"OTS-20-XXX-NNNNNN-TSKNM", where XXX 
is the LUN, NNNNNN is the event 
variable (two's complement) and 
TSKNM is the task name. 

direct-access errors: 

Undefined file 

Illegal record size 

Size discrepancy 

Too many records per file or illegal 
record number 

Mode discrepancy 
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Table 2-3 (Cont.) 
OTS Error Messages 



Number 


Possible Source 


Meaning 


26 (T) 


DEFINE 


Too many open files 


30 (R) 


RELEAE, .FPP 


Single integer overflow (detected only 
when fixing a floating-point number) 


31 (R) 


DBLINT, JFIX, 
JDFIX, ISNGL 


Extended (double) integer overflow; 
also prints PC with FPP system (with 
non-floating-point processor system, 
detected only when fixing a 
floating-point number) 


32 (R) 


RELEAE 


Single floating-point overflow; also 
prints PC with FPP system 


33 (R) 




Double floating-point overflow; also 
prints PC with FPP system (detected 
only by FPP system, not by software 
system) 


34 (R) 


RELEAE 


Single floating-point underflow; also 
prints PC with FPP system 


35 (R) 




Double floating-point underflow; also 
prints PC with FPP system (detected 
only by FPP system, not by software 
system) 


36 (R) 


RELEAE 


Floating-point divide check; also 
prints PC with FPP system 


37 (R) 


INTEAE 


Integer divide check; if extended 
integer divide check, prints PC with 
FPP system 


40 (T) 


ENCODE 


Illegal number of characters specified 
(legal: 0<c<625) 


41 (R) 


ENCODE 


Array exceeded 


42 (T) 


DDIO 


Bad input data 


43 (T) 


DA 


Attempt to pass more arguments than 
expected 


50 (T) 




FPP memory-protect/nonexistent memory; 
also prints PC with FPP system 


51 (T) 


BCDIO, BINIO 


READ to WRITE illegal I/O direction 
change to disk without intervening 
CLOSE or REWIND 
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In software systems, arithmetic errors resulting in the OTS error 
messages summarized above are detected in the eurithmetic package 
(RELEAE and INTEAE) . In the hardware FPP systems, these errors are 
detected by the hardware (with the exception of single integer divide 
check) and serviced by a trap routine in the FPP routine .FPP. 

Where applicaible, on such error conditions, the result is patched for 
both software and hardware systems as summarized in the following 
table. 



Table 2-4 
OTS Error Messages in FPP Systems 



Error 


Patched Value 


FPP Hardware System 


Software System 


Single Floating 
Overflow (.OTS 32) 


± largest single floating 
value 


Scune 


Double Floating 
Overflow (.OTS 33) 


± largest double floating 
value 


not detected 


Single Floating 
Underflow (.OTS 34) 


zero 


same 


Double Floating 
Underflow (.OTS 35) 


zero 


not detected 


Floating Divide 
Check (.OTS 36) 


± largest single floating 
value 


same 


Integer Overflow 
(.OTS 30) 


limited detection 


same 


Double Integer 

detection 
Overflow (.OTS 31) 


none 


limited 


Integer Divide 
Check (.OTS 37) 


none 


same 



"Limited detection" means that while a floating-point number is being 
fixed, integer overflow and extended integer overflow are detected. 
In these instances, plus or minus the largest integer for the data 
mode is patched as result. 

For Double Integer Overflow, "none" means that with the FPP system all 
extended integer overflow conditions are detected, but the results cire 
meaningless. Elsewhere, "none" means the result is mecuiingless. 

Further, when converting an extended integer, the magnitude of which 
is >2(17) -1, to a single integer, no error is indicated euid the high 
order digits are lost. 
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CHAPTER 3 
MACRO t ASSEMBLING A MACRO PROGRAM 



The MACRO Assembler produces relocatable binary object code that can 
be loaded for debugging or execution. The Assembler prepares the 
object program for relocation, and the Task Builder sets up linkages 
to external subroutines. 

The MACRO Assembler processes source programs in either a two-pass or 
three-pass operation. In the two-pass assembly operation the source 
program is read twice and the object program (and printed listing when 
requested) are produced during the second pass. During the first pass 
(PASSl) the locations to be assigned the progreun symbols are resolved 
and a symbol table is constructed by the Assembler. The second pass 
{PASS2) uses the information computed during PASSl to produce the 
final object program. 

In an optional three-pass assembly operation, PASS2 calls in a third 
pass (PASS3) portion of the Assembler program. PASS3, when called, 
performs a cross-referencing operation during which a listing is 
produced which contains all user symbols, where each symbol is 
defined, and the number of each program line in which a symbol is 
referenced. On completion of its operation, PASS3 calls the PASSl and 
PASS 2 portions of the Assembler program back into core for further 
assembly operations. 

The MACRO Assembler can also be invoked in batch mode. 



VII-3-1 



3.1 INVOKING THE MACRO ASSEMBLER 

The user Cein invoke the MACRO Assembler by typing a command according 
to the following format: 



Form: 



Where : 



Example ; 



MAC [RO] [option I , ] . . . ] -^name [ext] [,...] V 



option is a one-character symbol specifying 
an assembler option (see Table 3-1) ; option 
characters may be either concatenated or 
separated by commas 

name of program to be assembled is a string 
of one to six .SIXBT characters; one or 
more names may be required, depending on 
whether or not certain assembly options 
{e.g., FZ) have been requested; several 
programs may be specified so that they are 
assembled in sequence to produce separate 
binary files 

ext is a string of one to three .SIXBT 
characters representing the extension. SRC 
is the default 



Assemble program named TMAC, creating a 

binary file (B) and a listing (L) : 
TDV>MAC BL*-TMAC 

Assemble programs PI and P2 to produce a 
separate binary file (B) for each; both 
require the use of a parameter file (P) : 

TDV>MAC PB-«-PARAM,Pl,PARAM,P2 



Table 3-1 illustrates all Assembler options. Any nxamber of these 
options, in any order and optionally separated by commas, may be 
included in a TDV comm2md string. 



Option 



B 

L 



Table 3-1 
Assembler Options 



Action 



Generate a binary file 

Generate a listing file on 
the requested output device 

Number each source line (dec- 
imal) ; it is not necessary to 
type the L option 

Do not print program areas 
that fall between unsatisfied 
conditionals; it is not 
necessary to type the L option 



Default 



No binary file 

No listing file (see options 
N, C, G) 

Do not number source lines 



Print all source lines 



(Continued on next page) 
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Table 3-1 (Cont.) 
Assembler Options 



Option 



Action 



Default 



Print only the source line of 
a MACRO expansion; it is not 
necessary to type the L option 

Before assembly begins, read 
program petrameters from LUN- 
20; (the code read from LUN- 
20 is read only once; for 
this reason only direct as- 
signments should be used) 

Print symbols at end of PASS 2 
in alphanumeric sequence 



Print symbols at end of PASS2 
in value sequence 



Same as selecting both A and 
V above 



If A, V, or S option is used, 
print symbols one to a line 



At completion of PASS 2, load 
PASS 3 to perform the cross- 
referencing operation; at 
completion of PASS 3, the 
Assembler calls in PASSl and 
PASS 2 to continue assembling 
programs; if the command 
string is terminated by an 
ALTMODE, control returns to 
RSX at the end of assembly 

Do not output the source 
extension and the linking 
loader code 33 as a special 
code in the binary file; this 
option must be used when as- 
sembling programs in RSX to 
run in Background/Foreground 



Generate printouts for MACRO 
expansions and expandable 
pseudo-ops (e.g., .REPT) 

No parameters; begin assembly 
immediately after command 
string termination 



Do not print symbols in 
alphanumeric sequence (see 
options V, S, and H) 

Do not print symbols in value 
sequence (see options A, S, 
and H) 

Do not print symbols unless 
option A, option V, or both 
are requested (see option H) 

If A, V, or S option is used, 
print symbols horizontally, 
four to a line 

Do not provide a cross- 
reference and do not call in 
PASS 3 



Assemble as usual (use of 
unique extensions permits 
easy identification of dif- 
ferent versions of a program) 



(Continued on next page) 
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Table 3-1 (Cont.) 
Assembler Options 



Option 


Action 


Default 


E 


Print any errors occurring 


Output errors only to the 




during assembly on the 


listing device (LUN-16) 




console printer (LUN-13) in 






addition to the device 






assigned to LUN-16; the L or 






N option should be used with 






the I option; this option is 






particularly useful to users 






who assign nonprinting 






devices to LUN-16 




T 


Generate a Table of Contents 
during PASSl; the table will 
contain the page number and 
text of all assembled .TITLE 
statements in the program 


No table of contents 


R 


Identify assembler version 


Do not print version number. 




number; print END PASSl, END 


END PASSl, END PASS2, 




PASS 2, and error count on 


or error count 




output terminal 




I 


Ignore .EJECTS; treat the 


Skip to head of form when 




•EJECT pseudo-op as a com- 


.EJECT is encountered 




ment 




F 


Assembly includes an 
additional file: a macro 
definition file, a second 
parameter file, or a second 
part of the program file; 
this additional file is 
specified in the command 
string euid it is read via 
LUN-18; (see option Z) 


No additional file 


Z 


Assemble the file associated 


F-option file is referenced 




with the F option not only 


only during PASSl and 




during PASSl but also PASS2; 


therefore may contain 




this allows assembly of a 


only direct assignment 




two-part source file on two 


statements and comments 




different devices or on the 






same device; this option 






tcUces effect only if the F 






option is also specified 
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If the L and X options are entered in the same command string, MACRO 
assumes that the N option is also entered. Without the N option, the 
user would obtain a cross-reference that would be virtually useless, 
because the source lines of the listing would not be numbered. 



3.2 INPUT/OUTPUT 

The following LUN assignments should be made before the MACRO 
Assembler is invoked under MULTIACCESS: 

LUN Assignment 

13 Error messages (terminal recommended) 

15 Source file input 

16 Listing output 

17 Binary file output 

18 Secondary source file input 

20 Auxiliary input (terminal recommended) 

A secondary input device is needed to assemble a program from two 
different sources. An auxiliary input device is needed to supply 
parameters for a file that is to be assembled. 

If an I/O error occurs during assembly, the message: 

MAC- I/O ERROR LUN XX yyyyyy 

is produced on LUN-13. In the message, xx represents the logical unit 
number (decimal) and yyyyyy represents the event variable value 
(octal), indicating the cause of the error. 
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3.3 COMPARISON WITH OTHER VERSIONS OF MACRO 

The MACRO Assembler is essentially the same under RSX as it is under 
the other XVM monitor systems. The basic instructions and operation 
conventions are described in MACRO XVM ASSEMBLER LANGUAGE MANUAL. 

Nevertheless, RSX user interaction with the MACRO Assembler differs in 
some ways from the descriptions in the manual. The main differences 
occur in support of dump mode, input/output, parcuneter input, the 
definitions of certain steuidard functions and certain pseudo-ops. 
These differences are discussed in more detail below. 



3.3,1 Dvunp Mode 

MACRO under RSX supports all standard MACRO features except the 
pseudo-ops .lODEV, .ABS, .ABSP. .FULL, and .FULLP. This is because 
RSX !l70 Device Handler Tasks do not support d\raip mode (mode 4) . 



3.3.2 Input/Output 

The Assembler's Input Command Decoder has been modified to use 
standard Task Development function input and to assemble multiple 
files with the same switches. For example: 



MAC BNX-<-FILEl,FILE2 

causes the MACRO Assembler to assemble progreuns FILEl and 
sequence cind to produce separate binary files and listings. 



FILE2 in 



3.3.3 Parameter Input 

If the P assembly option is used and input is to come 
teinninal, the MACRO Assembler types the following message: 

MAC-INPUT PARAMETER DEFINITIONS 



from the 



on the output terminal (LUN-20) . The user responds by entering input 
parameters. To terminate input, he types a CTRL/D (+D) followed by a 
ceurriage return. 



3.3.4 MACRO Definitions File 

The RSX Assembler does not contain within itself the definition of 
standard, frequently-used System Directive and I/O calls. These exist 
in a MACRO Definitions File (RMC.nn SRC where nn is the current edit 
number) which is provided as part of the RSX system. During assembly, 
this definition file can be accessed via the secondary-input LUN 
(LUN-18) if assembly option F is specified. (Z is also needed when 
two passes are required.) This file cannot be read via the auxiliary 
input LUN (LUN-20) using the P option because many MACROS make forwaurd 
symbolic references, necessitating a second pass on the file. 
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3.4 ERROR MESSAGES 

The Assembler examines each source statement for possible errors. A 
statement containing an error is flagged by one or several letters in 
the left-hand margin of the line, or, if the lines eire numbered, 
between the line number and the location. The following table lists 
error flags euid their meemings. 



Table 3-2 
MACRO Assembler Error Flags 



Flag 


Meaning 


A 


Error ir 
ignored 


I direct symbol table assignment - assignment 


B 


1. 


Memory beuik error (program segment too 
leurge) 




2. 


Page error - the location of an instruction 
and the address it references are on 
different memory pages (error in page mode 
only) 


C 


A .ENDC or a .CBE is given with no opening 
conditional. The error appears on the offending 
line. 


D 


Statement contains a reference to a multiply-defined 
symbol - the first value is used 


E 


1. 


Symbol not found in user's symbol t2d3le 
during PASS 2 




2. 


Operator combined with its operand may 
produce erroneous results 


F 


Forward 
PASS2 


reference - symbol value is not resolved by 


I 


Line ignored: 




1. 


Redundcuit pseudo-op 




2. 


A second .LOCAL pseudo-op appears before a 
matching .NDLOC pseudo-op 




3. 


An .NDLOC appears without an associated 
•LOCAL pseudo-op 




4. 


Too many .LTORG pseudo-ops (more than eight) 


L 


Literal 


error: 




1. 


Phase error - literal encountered in PASS2 
does not equal any literal found in PASSl 




2. 


Nested literal (a literal within a literal) 



(Continued on next page) 
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Table 3-2 (Cont.) 
MACRO Assembler Error Flags 



Flag 


Meeuiing 


M 


Multiple symbol definition - first value defined is 
used 


N 


Error in number usage (digit 8 or 9 used under .OCT 
influence) 


P 


Phase error: 




1. PASSl symbol value not equal to PASS 2 symbol 
value (PASS 2 value ignored) 




2. A tag defined in a local area (.LOCAL 
pseudo-op) is also defined in a non-local 




2u:ea 


Q 


Questionable line: 




1. Line contains two or more sequential 
operators (e.g. , LAC A+*B) 




2. Bad line delimiter - address field not 
terminated with a semicolon, carriage 
return, or comment 




3. Bad argument in .REPT pseudo-op 


R 


Possible relocation error 


S 


Symbol error - illegal character used in tab field 


U 


Undefined symbol 


W 


Line overflow during macro expansion 


X 


Illegal use of macro name or index register 


y 


A .CBS was given with no closing .CBE, a .DEFIN has 
no corresponding .ENDM and/or a .IF conditional has 
no closing .ENDC. This error is output on the .END 
statement at the end of PASS 1. 
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In addition, certain conditions cause assembly to be terminated 
prematurely. The following table lists possible error messages and 
their meanings. 



table 3-3 
MACRO Assembler Error Messages 



Message 



SYNTAX ERR 



NAME ERROR 



TABLE OVERFLOW 



CALL OVERFLOW 



CORE EXHAUSTED 
AT LINE nnn 



Meeming 



Bad command string; control 
returns to TDV 

File ncuned in commeuid string 

not found; control returns to TDV 

Too many symbols and/or MACROs; 
control returns to TDV 

Too memy embedded MACRO calls; 
control reutrns to TDV 

PASS 3 error; too many symbol 
references ; control 
returns to TDV 
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CHAPTER 4 
EDITOR; TEXT-EDITING SOURCE CODE 



The Text Editor is an effective text editing program that allows the 
modification and creation of symbolic source programs and other ASCII 
text material. The Editor reads and writes standard lOPS ASCII lines. 
By means of keyboard commands, the Editor is directed to bring a line 
or group of lines from an input file to an internal buffer. By means 
of additional commands, the user can then examine, delete and change 
the contents of the buffer, and insert new text at any point in the 
buffer. When the line or block of lines has been edited, it is 
written into a new file on the output device. 

The Editor is most frequently used to modify MACRO and FORTRAN IV 
source programs, but it can also be used to edit any symbolic text. 

The Editor operates in either an "edit" or "input" mode. In the 
"edit" (or command) mode, the program accepts and acts on control-word 
and data strings to open and close files; to bring lines of text from 
an open file into the work area; to change, delete or replace the 
line currently in the work area; and to insert single or multiple 
lines after the line in the work area, in the "input" (or text) mode, 
lines from the keyboard are interpreted as text to be added to the 
open file. Commands are available for conveniently changing from one 
operating mode to the other. 

Data from the input file are made available for editing in two ways: 
in line-by-line mode or in block mode. in the line-by-line mode, a 
single line is the unit of the input file available to the user for 
modification at any point. In the block mode, a user-specified 
portion of the input file is held in a core buffer for editing until 
the user requests that the contents of the buffer be added to the 
output file. Line-by-line mode is the default data mode. 



4.1 INVOKING THE TEXT EDITOR 

The user can invoke the Text Editor by typing a command in the format: 



Form: 


TDV>EDIV 



TO return to the MULTIACCESS Monitor after editing and closing a file, I 
the user must type: 
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E[XIT1 



An example of interaction with the Text Editor follows (> is a 
prompter) : 



TDV>EDI 

EDITOR XVM/RSX VlBOOO 

>OPEN FILNAM EXT 

EDIT 

> 

>T 



>N 
>P 

•TITLE FILNAM 

>C /TOR/TION/ 

•TITLE FILNAM 

>CLOSE 

>EXIT 

TDV> 



User invokes Text Editor 

Editor gives version number 

Open the file FILNAM, with extension 

EXT, for editing 

Editor indicates EDIT mode 

Go to top of file 

Print current line; nothing is printed, 

because pointer is above first line 

of file 

Go to next line 

Print current line 

/EDIT COMMAND DEMONSTRATOR 

Change DEMONSTRATOR to DEMONSTRATION 

/EDIT COMMAND DEMONSTRATION 

Close file 

Exit from Text Editor 



4.2 INPUT/OUTPUT 

Make the following LUN assignments before the Text Editor is invoked 
under TDV: 



LUN Assignment 

16 Auxiliary output (listing) 

17 Source file input/output (disk) 

18 Source file scratch input/output 
(temporary file) (disk) 

19 Auxiliary output file (disk) 

20 Auxiliary input 

If an I/O error occurs during editing, the message: 

EDI - I/O ERROR LUN xx yyyyyy 

is sent to LUN-13. In the message, xx represents the logical unit 
number (decimal) and yyyyyy represents the octal event variable, 
indicating the cause of the error. 



XVM/RSX VlB 
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4.3 COMPARISON WITH OTHER VERSIONS OF THE TEXT EDITOR 

The Text Editor runs the same way under RSX as it does under the other 
XVM operating systems. Program commands and conventions are described 
in the EDIT/EDITVP/EDITVT XVM Utility Manual. 

RSX user interaction with the Text Editor differs in some ways from 
the descriptions in the manual. The main differences occur in 
disk-to-disk editing, buffer size and partition size. The differences 
are described in detail in the following sections. 



4.3.1 Disk-to-Disk Editing 

RSX supports all standard EDIT features, but is restricted to 
disk-to-disk editing. Therefore, LUN-17 and LUN-18 must be assigned 
the to disk. 



4.3.2 Buffer and Partition Size 

On program initialization, the maximum buffer size parameter for the 

SIZE command is computed. The parameter retains the computed value or 

is set to 56, whichever is smaller. The SIZE command is then 

restricted to a value less than or equal to the maximum buffer size. 

If the partition size is too small to permit buffers, the message: 

EDI-PARTITION TOO SMALL 

is set to LUN-13 and the Text Editor exits. 



4.4 ERROR MESSAGES 

When a colon follows an error message, the incorrect command line is 
printed below the error message. 
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Table 4-1 
Editor Error Messages 



Message 


Meaning 


BUFFER NON-EMPTY 


BLOCK OFF comniemd issued 
before Block Buffer emptied by 
WRITE command 


NOT A REQUEST: 


Commcuid string error 


? 


Command string error while 
BRIEF mode ON 


END OF BUFFER REACHED BY: 


Command has moved pointer 
below last line 


END OF FILE REACHED BY: 


Command has moved pointer 
below last line 


READ ERROR: 


Incorrect parity or checksum 


TRUNCATED: 


Line too long 


BUFFER CAPACITY EXCEEDED BY: 


Buffer overflowed in Block 
Mode 


NO FILE NAME GIVEN. 


File name missing 


NO INPUT FILE PRESENT. 


Input file missing 


FILE name IS PRESENT ON OUTPUT 
DEVICE. PLEASE RENAME IT OR IT 
WILL BE DELETED. 


More than one file called name 


NOTHING IN FILE 


No output to file 


SIZE TOO SMALL 


When Block Mode is ON, number 
of lines specified in MOVE > 
size of current block buffer 


NOT ENOUGH LINES 

END OF FILE REACHED BY: 


When Block Mode is OFF, number 
of lines MOVE specifies to be 
moved > number in current file 


NOT ENOUGH BUFFER SPACE 


Not enough buffer space to 
store lines being moved 


LINES MOVED TO END 


Line containing text string 
specified in MOVE not found 


NO STRING 


Convert missing first argument 


NOT FOUND 


First argument of CONVERT 
never found 
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OIAPTER 5 
SLIP: EDITING BATCH FILES 



The SLIP command invokes a batch-oriented file editor, which not only 
can edit ASCII source programs and data sets, but can also produce 
line-numbered listings and perform operations similar to those of 

SLIP complements EDIT, the TDV interactive Text Editor. SLIP is 
designed particularly for batch operation or for file manipulation, 
while EDIT is designed for the on-line user who manipulates text 
within a single file. SLIP works at the record level, while EDIT has 
extensive intrarecord facilities. 



SLIP processes as many as four streams of information 
shown in the following diagram: 



in a run, as 



Correction Input 
(commands and insertion) 



input 
(original file) 




O output 
(edited file) 



external 

file 

inputs 



This editor SLIPs information from one file to another. it always 
generates a new file so that the original file can be preserved. 
Batch operation requires this; otherwise a minor chancre. " 
specified, could destroy an important file. — - ---™' 
many backup levels. 



^_, incorrectly 

The user can maintain 
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5.1 INVOKING SLIP 

The user can invoke SLIP in one of two ways, 
has the following format: 



From TDV, the command 



Form: 



Where: 



Example : 



SLIP option [,...] V 



option is an option from Table 5-1 



TDV>SLIP N 



The user can also invoke SLIP in BATCH mode as part of a job with the 
following control record: 

$SLIP options 

as explained in 5.1.1. 

A SLIP run must contain the following four sections: 

1. TDV>SLIP options or $SLIP options 

2. *FILE specifications 

3. SLIP control records and insertion records 

4. End-of-file (-$ in DV or $EOF in BATCH or TDV) 



5.1.1 $SLIP Options 

The $SLIP record has the following format: 



Form: 



Where! 



Example : 



$SLIP option [,...] 



option is ein option from Table 5-1 



List output file and suppress trailing spaces 
of input file: 

$SLIP L,S 
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Table 5-1 
SLIP Options 



Option 



N[LIST] 
CtHANGES] 

L[IST] 

K[EEP] 
S(UPPRESS] 



Meaning 



No printout except *FILE cards and errors 

List control records, deleted lines, *FILE cards, 
and errors (default) 

List entire output file, with line numbers, 
inserted lines, deleted lines, *PILE cards, and 
errors 

Retain trailing spaces on input records 

Suppress trailing spaces (in multiples of 5) from 
input record (default) 



5.1.2 *FILE Specifications 

SLIP uses *FILE, an indirect file selection system. The user must 
specify exactly one input and one output file as follows: 



Form: 



Where: 



Example : 



*FILE I [NPUT] :LUN=' [inf ile [ext] J '0 [UTPUT] 
LUN=' [outf ile [ext] ] • $ 



one- or two-digit Logical Unit 



LUN is a 

Number 
inf ile is a string of one to six .SIXBT 

characters representing the input file and 

is optional only if the input LUN is 

non- file-oriented 
ext is a string of one to three .SIXBT 

characters representing the file extension 
outfile is a string of one to six .SIXBT 

characters representing the output file and 

is optional only if the output LUN is 

non-file-oriented 



Input FILEl RC from LUN-17 to be edited and 

output on LUN-18: 
*FILE I: 17= 'FILEl SRC' ; 18= 'FILEl SRC'$ 



The inf ile ext and outfile ext can be identical, but it is better to 
keep a backup file. If a backup file is desired, the user should 
enter a sequence such as the following: 



VII-5-3 



$DELETE file bak 

$RENAME file src, file bak 

$SLIP options 

*FILE I:LUN='file bak' 0:LUN='file src' 



$EOF 



If the user then makes a bad edit riin, she can remove the $DELETE and 
$RENAME records and rerun the update, because the original file is 
still intact as "file bak." 

Note that certain SLIP commands described below require additional 
*FILE records. 



5.1.3 SLIP Control Records and Insertion Records 

SLIP logically numbers all lines within each file it processes so that 
the first line in each file is number 1. If a SLIP run includes a LIST 
option, but no control or insertion records, it produces a line 
printer listing of the file with line numbers as in the example below. 

Whether or not the run includes control emd insertion records, the 
listing always shows the final, resultant line numbers, those to be 
used for the next SLIP performed on that file. Because the 
renumbering occurs after editing and before output of the listing, the 
user refers while editing to the original line numbers. 

Renumbering does occur, however, when any of the four search commands 
is used. The line selected by the search becomes line 1. Line 
references in all subsequent commands are then relative to that line. 
For instance, after a command causes a search for 'C in the sample 
input file below, the command 

-3,3 

will delete the line containing 'E', which was originally line 5. 

Each search sets the selected line to 1. It is impossible to reference 
the original line numbers after any search has been conducted. 

The file in the example below will be the input file for all 
subsequent SLIP examples: 



e: 1. 


A 


2. 


B 


3. 


C 


4. 


D 


5. 


E 


6. 


F 


7. 


G 
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Subsequent sections give details on the nine 
which are: 

. INSERT 



SLIP control commands , 



. INSERT FILE 

. REPLACE 

. REPLACE WITH FILE 

. SEARCH AND INSERT 

. SEARCH AND INSERT FILE 

. SEARCH AND REPLACE 

. SEARCH AND REPLACE WITH FILE 

. END-OF-FILE 

All control commands must follow the *FILE specification and must 
begin with a minus sign (-) in column one, followed by one or more 
parameters. Embedded blanks are allowed within the parameters and are 
ignored except when between single quotes (•). The commands that 
permit insertion of an entire file are especially useful for inserting 
subroutines. ^ 



5.1.4 End-of-File 

A set of correction cards must be terminated by an end-of-file 

specification. This is $EOF in BATCH mode or the command -$ in BATCH 

or TDV. "iv-ri 



5.2 CONTROL RECORDS 

The following sections summarize SLIP control records and orovide 
examples of usage. *^ 
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5.2,1 INSERT 



The user can specify an INSERT operation by a control record of the 
following format: 



Form: 



Where: 



-n 



n is the ninnber of the line after vrtiich the 
insertion will be made 



All records that follow the INSERT control record and precede another 
control record or an $EOF are inserted into the output file following 
line n of the input file. For example if the following records 

-1 
X 
Y 
Z 

-$ 

are specified to edit the input file in 5.1.3, the resulting output 
file is: 



1. 


A 


2. 


X 


3. 


Y 


4. 


Z 


5. 


B 


6. 


C 


7. 


D 


8. 


E 


9. 


F 


10. 


G 
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5.2.2 INSERT FILE 

An INSERT FILE operation requires two control records. The first is 
in the format: 



Form: 



-n 



Where: 



n is the number of the line after which the 
insertion is to be made 



The second record is a *FILE record in the format: 



Form: 


*FILE I[NPUT] :LUN='secfile exf 


Where: 


LUN is the logical unit number, which must 




be different from those used for the input 




and output files of the edit 




secfile is a string of one to six .SIXBT 




characters representing the file to be 




inserted 




ext is a string of one to three .SIXBT 




characters representing the file extension 



The entire second file is inserted into the input file after relative 
line number n. Another control record usually follows the *FILE 
record. If noncontrol records follow it, they are inserted after the 
last line of the inserted file and before the next line of the input 
file. 

For example, if the second file, ZZZ RC, consists of: 



1. 


XX 


2. 


YY 


3. 


ZZ 


4. 


KK 



and is inserted into the input file in 5.1.3 by the commands: 

-1 

♦FILE 1:15=' ZZZ SRC'$ 

the resulting output file is: 



1. 


A 


2. 


XX 


3. 


YY 


4. 


ZZ 


5. 


KK 


6. 


B 


7. 


C 


8. 


D 


9. 


E 


10. 


F 


11. 


G 
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5.2.3 REPLACE 

The user can specify a replacement by a control record of the 
following format: 



Form: 


-n,m 


Where: 


n is the number of the first line to be deleted 

and replaced 
m is the number of the last line to be deleted 

cutd replaced 



All input file records numbered n through m, inclusive, are deleted 
and all insertion records following the REPLACE control record are 
inserted in the output file following the {n-l)th record of the input 
file. 

Note that if no records are inserted, lines n through m are deleted. 
The command 

-204,99999 
deletes all lines after 203. The command 

-204,204 

deletes only line 204. 

The following example illustrates the case in which records are 
inserted. If the records 

-2,4 

X 

Y 

Z 

-$ 

are specified to edit the input file in 5.1.3, the resulting output 
file is: 



1. 


A 


2. 


X 


3. 


Y 


4. 


Z 


5. 


E 


6. 


F 


7. 


G 
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5,2.4 REPLACE WITH FILE 

A REPLACE WITH FILE operation requires two control records. The first 
is in the following format: 



Form: 



Where: 



-n,m* 



n is the nvimber of the first line to be deleted; 

second file will follow line n-1 

m is the number of the last line to be deleted; 

second file will precede line m+1 



The second record is a *FILE record in the following format i 



Form: 



Where: 



*FILE I[NPUT] :LUN=i'secfile ext* 



LUN is the Logical Unit Number 

secfile is a string of one to six .SIXBT 

characters representing the file to replace 

the deleted lines 
ext is a string of one to three .SIXBT 

characters representing the file extension 



Lines n through m are deleted and replaced with the entire second file 
specified. Another control record usually follows the *FILE record. 
If other insertion records follow it, they are inserted after the last 
line of the second file. 

For example, if the following control records: 

-3,4* 

*FILE 1:15=' ZZZ SRC'$ 

-$ 

are specified to delete lines 3 and 4 of the input file in 5.1.3 and 
to replace them with the second file, ZZZ SRC in 5. 2. 2, the resulting 
output file is: 



1. 


A 


2. 


B 


3. 


XX 


4. 


YY 


5. 


ZZ 


6. 


KK 


7. 


E 


8. 


F 


9. 


G 



VII-5-9 



5.2.5 SEARCH AND INSERT 

The user can specify a SEARCH AND INSERT operation by a control record 
of the following format: 



Form: 



Where: 



-'xxxxx' 



xxxxx is a string of one to five characters; 
the insertion will be made after the line 
beginning with the string 



The search facility is designed to detect FORTRAN line numbers. SLIP 
examines each line of the input file until it finds one beginning with 
the string xxxxx. All lines that follow the SEARCH AND INSERT control 
record and precede another control record or $EOF are inserted into 
the output file following the line containing xxxxx in the input file. 

For excimple, if the following records 

-•a' 

X 
Y 
Z 

-$ 

are specified to edit the input file in 5.1.3, the resulting output 
file is: 



1. 


A 


2, 


X 


3. 


Y 


4. 


Z 


5. 


B 


6. 


C 


7. 


D 


8. 


E 


9. 


F 


10. 


G 



Renumbering occurs when the search is successful, 
by the search becomes line 1. 



The line selected 
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5.2.6 SEARCH AND INSERT FILE 



A SEARCH AND INSERT FILE operation requires two control records, 
first is in the following format: 



The 



Form: 


- ' xxxxx ' * 


Where: 


xxxxx is a string of one to five characters; 
the file will be inserted after the line in 
which the string appears 



The second record is a *FILE record in the following format: 



Form: 



*FILE I[NPUT] :LUN='secfile ext'$ 



Where: 



LUN is the Logical Unit Niimber 

secfile is a string of one to six .SIXBT 

characters representing the file to be 

inserted 
ext is a string of one to three .SIXBT 

characters representing the file extension 



SLIP examines each line of the input file until it finds one beginning 
with the string xxxxx. The entire second file is inserted into the 
output file after the line containing xxxxx. Another control record 
usually follows the *FILE record. If other insertion records follow 
it, they are inserted after the last line of the inserted file. 

For example, if the following records 

-•A* 

*FILE I:15='ZZZ SRC»$ 
-$ 



are specified to insert the second file, ZZZ SRC in 5.2.2, after 
1 of the input file in 5.1.3, the resulting output file is: 



line 



1. 


A 


2. 


XX 


3. 


YY 


4. 


ZZ 


5. 


KK 


6. 


B 


7. 


C 


8. 


D 


9. 


E 


10. 


F 


11. 


G 



Renumbering occurs when the search is successful, 
by the search becomes line 1. 



The line selected 
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5.2.7 SEARCH AND REPLACE 

The user can specify a SEARCH AND 
record of the following fonnat: 



REPLACE operation by a control 



Form: 


-'xxxxx' ,in 


Where: 


xxxxx is a string of one to five characters; 

the line containing the string is the first 

to be deleted and replaced 
m is the ntunber of the last line to be 

deleted and replaced 



SLIP examples each line of the input file until it finds one beginning 
with the string xxxxx. All input file records from the line 
containing the string through line m, inclusive, are deleted. 

All insertion records following the SEARCH AND REPLACE control record 
are inserted in the output file following the record just before the 
record containing xxxxx. 

Note that if no records eure inserted, the specified lines are deleted. 
The conanand 

-'ABC', 99999 
deletes all lines after the one containing 'ABC*. The commeind 

-•ABC',1 

deletes only that line. 

The following example illustrates the case in which records are 
inserted. If the records 

-•B',3 
X 
Y 
Z 

-$ 



are specified to edit the input file in 5.1.3, the 
file is: 



resulting output 



1. A 

2. X 

3. Y 

4. Z 

5. E 

6. F 

7. G 



Renumbering occurs when the search is successful. The line selected 
by the search becomes line 1. 
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5.2.8 SEARCH AND REPLACE WITH FILE 

A SEARCH AND REPLACE WITH FILE operation requires two control records. 
The first is in the following format: 



Form: 



-'xxxxx' , in* 



Where: 



xxxxx is a string of one to five characters; 

the line containing the string is the first 

to be deleted; second file will follow the 

preceding line 
m is the number of the last line to be 

deleted; second file will precede line m+1 



The second record is a *FILE record in the following format: 



Form: 



*FILE I[NPUT] :LUN=«secfile ext'$ 



Where; 



LUN is the Logical Unit Number 

secfile is a string of one to six .SIXBT 

characters representing the file to replace 

the deleted lines 
ext is a string of one to three .SIXBT 

characters representing the file extension 



SLIP examines each line of the input file until it finds one beginning 
with the string xxxxx. All input file records from the line 
containing the string through line m, inclusive, are deleted and 
replaced with the file specified. Another control record usually 
follows the *FILE record. If other insertion records follow it, they 
are inserted after the last line of the second file. 

For example, if the following records: 

-•C',2* 

♦FILE I:15='ZZZ SRC'$ 

-$ 

are specified to delete lines 3 and 4 of the input file in 5.1.3 and 
to replace them with the second file, ZZZ SRC in 5.2.2, the resulting 
output file is: 



1. 


A 


2. 


B 


3. 


XX 


4. 


YY 


5. 


ZZ 


6. 


KK 


7. 


E 


8. 


F 


9. 


G 



Renumbering occurs when the search is successful, 
by the search becomes line 1. 
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The line selected 



5.2.9 END-OF-FILE 

The user can specify END-OF-FILE by a control record of the following 
format : 

-$ 



5.3 INPUT /OUTPUT 

The SLIP TDV Function Task is assigned Task name SLI... at 
Task-Building time. SLIP uses LUN-12 for command input and LUN-16 for 
listing output. The user may use Logical Units for files as he 
wishes. Normal editing operations use LUN-17 for input, LUN-18 for 
output, and LUN-15 for secondary input. 



5.4 ERROR MESSAGES 

SLIP detects four types of errors: 

. *FILE specification errors 

. $SLIP control record errors 

. SLIP command syntax errors 

. SLIP sequencing errors 

5.4.1 *FILE Errors 

A message of the following foinn indicates a *FILE error: 

*FILE ACCESS ERROR XX — PROGRAM TERMINATED 
where xx is a code in Table 5-2. 
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Table 5-2 
Error Codes for *FILE Routine 



Code 



Meaning 



1 
2 

3 
4 
5 
6 

7 
8 
9 

10 
11 
12 
13 
14 
15 
16 
17 
18 

19 



*FILE does not appear in columns 1-5 of card read 

File type inputs or outputs not found 

Colon missing after file type 

Missing Logical Unit Number (i.e., INPUT :=' file • ) 

Logical Unit Number does not consist of digits 0-9 

Logical Unit Number is too long (more than 2 digits) 

Missing equal sign (=) after Logical Unit Number 

Missing quote ( ' ) after equal sign 

Invalid delimiter within file name or missing quote ( ' ) 
after file name 

Illegal file type, not INPUT: or OUTPUT: 

File not found on input device 

File already open for output 

Not enough space in partition for buffer 

Logical Unit is not assigned to a device 

Empty system pool 

File I/O error other than codes 11-15 

File already open but CcUinot be closed 

File name is greater than 8 characters (only first 6 
are used) ; probably missing space between file ncune and 
extension or missing quote ( ' ) 

Incorrect number of files specified; input does not 
meet program requirement 



5.4.2 $SLIP Control Record Errors 

Selecting a nonexistent processing option causes a nonfatal $SLIP 
control record error of the following form: 

SLIP DOES NOT HAVE A X OPTION 

where x is the nonexistent option. 
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5.4.3 SLIP Command Syntax Errors 

SLIP command syntax errors are more serious, for they might cause 
considereible damage to a file. Therefore, most errors of this type 
cause SLIP to perform a reasonable action. It usually runs through to 
the end-of-file, copying the rest of the input file into the output 
file. 

Illegal characters in the command line are detected, however. They 
cause the following message to appear: 

CORRECTION CARD ERROR — ILLEGAL CHARACTER X 

where x is the illegal character. Because the faulty line is treated 
as if it were 



-99999 

SLIP processes through to the end-of-file, making 
corrections. The remaining commcind records are ignored. 



no further 



5.4.4 SLIP Sequencing Errors 

A SLIP sequencing error is caused by a reference to a line number that 
has already been passed. This indicates that the correction deck is 
out of order. SLIP exits immediately after producing a message of the 
following form: 

CORRECTION CARD ERROR 

CURRENT LINE = XX 

AFFECTED LINE - XX ~ XX 

If an existing file bears the same name as the output file specified, 
the existing file is retained. If not, a new but incomplete file is 
generated. 



5.5 DEMONSTRATION OF SLIP EDITING 

$LIST SLTJOB JOB 

page eject 

SJOB 50(002) DEMONSTRATION OF SLIP EDITING 

$LIST SLTJOB JOB 

$DECK TESTIN SRC 

AAAAAAAA 

BBBBBBBB 

CCCCCCCC 

DDDDDDDD 

EEEEEEEE 

FFFFFFFF 

GGGGGG66 

HHHHHHHH 
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IIIIIIII 
JJJJJJJJ 

KKKKKKKK 

LLLLLLLL 

MMMMMMHM 

$EOF 

SLIST TESTIN SRC 

$SLIP L,S 

*FILE IN:17='TESTIN SRC' OUT:18='TESTOU SRC $ 

-$ 

$SLIP L,S 

*FILE IN: 17= 'TESTIN SRC' 0UT:18='TEST0U SRC' $ 

-3 

XXXXXXXX 

YYYYYYYY 

ZZZZZZZZ 

-$ 

$LIST TESTOU SRC 

$SLIP L,S 

*FILE IN: 17= 'TESTIN SRC' OUT: 18= 'TESTOU SRC' $ 

-2,5 

XXXXXXXX 

YYYYYYYY 

ZZZZZZZZ 

-$ 

$LIST TESTOU SRC 

$SLIP I.,S 

*FILE IN: 17= 'TESTIN SRC' OUT: 18= 'TESTOU SRC' $ 

-'GGG' 

-2,2 

XXXXXXXX 

-s 

$LIST TESTOU SRC 

$DECK EXTIN SRC 

/THIS IS A USEFUL WAY 

/OF INSERTING OPERATING 

/INSTRUCTIONS INTO A LISTING WITHOUT 

/HAVING TO TYPE THEM TWO OR MORE TIMES. 

$EOF 

$LIST EXTIN SRC 

$SLIP L,S 

*FILE IN: 17= 'TESTIN SRC' OUT: 18= 'TESTOU SRC' $ 

-3* 

*FILE IN: 15= 'EXTIN SRC' $ 

-6* 

*FILE IN: 15= 'EXTIN SRC' $ 

-$ 

SLIST TESTOU SRC 

$SLIP L,S 

*FILE IN: 17= 'TESTIN SRC OUT: 18= 'TESTOU SRC $ 

-•HHH',2* 

♦PILE IN: 15= 'EXTIN SRC $ 

-$ 

$LIST TESTOU SRC 

$END 

SDECK TESTIN SRC 

$LIST TESTIN SRC 
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page eject 

AAAAAAAA 
BBBBBBBB 
CCCCCCCC 
DDDDDDDD 
EEEEEEEE 
FFFFFFFF 
GGGGGGGG 
HHHHHHHH 
IIIIIIII 
JJJJJJJJ 
KKKKKKKK 
LLLLLLLL 
MMMMMMMM 

page eject 

$SLIP L,S 

*FILE IN:1717»'TESTIN SRC' 0UT:18'TEST0U SRC' 



**CHANGE** -$ 

1 AAAAAAAA 

2 BBBBBBBB 

3 CCCCCCCC 

4 DDDDDDDD 

5 EEEEEEEE 

6 FFFFFFFF 

7 GGGGGGGG 

8 HHHHHHHH 

9 IIIIIIII 

10 JJJJJJJJ 

11 KKKKKKKK 

12 LLLLLLLL 

13 MMMMMMMM 



********** SLIP COMPLETE ********** 



page eject 

$SLIP L,S 

*FILE IN:17='TESTIN SRC' OUT : 18= ' TESTOU SRC' 



**CHANGE** -3 

1 AAAAAAAA 

2 BBBBBBBB 

3 CCCCCCCC 

4 XXXXXXXX 
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5 


YYYYYYYY 


6 


ZZZZZZZZ 


**CaiANGE** 


-$ 


7 


DDDDDDDD 


8 


EEEEEEEE 


9 


FFFFFFFF 


10 


GGGGGGGG 


11 


HHHHHHHH 


12 


IIIIIIII 


13 


JJJJJJJJ 


14 


KKKKKKKK 


15 


LLLLLLLL 


16 


MMMMMMMH 



********** 



SLIP COMPLETE ********** 



$LIST TESTOU SRC 

page eject 

AAAAAAAA 
BBBBBBBB 
CCCCCCCC 
XXXXXXXX 
YYYYYYYY 
ZZZZZZZZ 
DDDDDDDD 
EEEEEEEE 
FFFFFFFF 
GGGGGGGG 
HHHHHHHH 
IIIIIIII 
JJJJJJJJ 
KKKKKKKK 
LLLLLLLL 
MMMMMMMM 

page eject 

$SLIP L,S 

♦FILE IN:17='TESTIN SRC' UT : 18= ' TESTOU RC $ 



**CHANGE** -2,5 

1 AAAAAAAA 
**DELETE** BBBBBBBB 

2 XXXXXXXX 

3 YYYYYYYY 

4 ZZZZZZZZ 
**CHANGE** -$ 
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**DELETE** 


ccxrccccc 


*»DEIiETE** 


DDDDDDDD 


**DELETE** 


EEEEEEEE 


5 


PPPPFPFF 


6 


GG6GGGGG 


7 


HHHHHHHH 


8 


IIIIIIII 


9 


JJJJJJJJ 


10 


KKKKKKKK 


11 


LLLLLLLL 


12 


MMMMMMMM 



********** SLIP COMPLETE ********** 



$LIST TESTOU SRC 
page eject 
AAAAAAAA 

xxxxxxxx 

YYYYYYYY 
ZZZZZZZZ 
FPFFFFPP 
GGGGGGGG 
HHHHHHHH 
IIIIIIII 
JJJJJJJJ 
KKKKKKKK 
LLLLLLLL 
MMMMMMMM 

page eject 

$SLIP L,S 

*PILE IN:17='TESTIN RC' OUT : 18= ' TESTOU SRC' 



**CHANGE** 


-•GGG* 


1 


AAAAAAAA 


2 


BBBBBBBB 


3 


CCCCCCCC 


4 


DDDDDDDD 


5 


EEEEEEEE 


6 


FFFFFFFF 


7 


GGGGGGGG 


**CHANGE** 


-2,2 


**DELETE** 


HHHHHHHH 


8 


XXXXXXXX 


**CHANGE** 


-$ 


9 


IIIIIIII 
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10 JJJJJJJJ 

11 KKKKKKKK 

13 MMMMMMMH 



********** SLIP COMPLETE ********** 



$LIST TESTOU SRC 

page eject 

AAAAAAAA 

BBBBBBBB 

CCCCCCCC 

DDDDDDDD 

EEEEEEBE 

FFFFFFFF 

GGGGGGGG 

XXXXXXXX 

IIIIIIII 

JJJJJJJJ 

KKKKKKKK 

LLLLLLLL 

MMMMMMMM 

$DECK EXTIN SRC 

$LIST EXTIN SRC 

page eject 

/THIS IS A USEFUL WAY 
/OF INSERTING OPERATING 
/INSTRUCTIONS INTO A LISTING WITHOUT 
/HAVING TO TYPE THEM TWO OR MORE TIMES. 

page eject 

$SLIP L,S 

♦FILE IN:17='TESTIN SRC' OUT: 18= 'TESTOU SRC' S 



**CHANGE** -3* 

♦FILE IN: 15= 'EXTIN SRC' $ 

1 AAAAAAAA 

2 BBBBBBBB 

3 CCCCCCCC 

4 /THIS IS A USEFUL WAY 

5 /OF INSERTING OPERATING 

6 /INSTRUCTIONS INTO A LISTING WITHOUT 

7 /HAVING TO TYPE THEM TWO OR MORE TIMES. 
**CHANGE** -6* 
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♦FILE IN:15='EXTIN SRC $ 

8 DDDDDDDD 

9 EEEEEEEE 

10 PFFFFPFP 

11 /THIS IS A USEFUL WAY 

12 /OF INSERTING OPERATING 

13 /INSTRUCTIONS INTO A LISTING WITHOUT 

14 /HAVING TO TYPE THEM TWO OR MORE TIMES. 
**CHANGE** -$ 

15 GGGGGGGG 

16 HHHHHHHH 

17 IIIIIIII 

18 JJJJJJJJ 

19 KKKKKKKK 

20 LLLLLLLL 

21 MMMMMMMM 



********** SLIP COMPLETE ********** 



$LIST TESTOU SRC 

page eject 

AAAAAAAA 

BBBBBBBB 

CCCCCCCC 

/THIS IS A USEFUL WAY 

/OF INSERTING OPERATING 

/INSTRUCTIONS INTO A LISTING WITHOUT 

/HAVING TO TYPE THEM TWO OR MORE TIMES. 

DDDDDDDD 

EEEEEEEE 

FFPFFPFF 

/THIS IS A USEFUL WAY 

/OF INSERTING OPERATING 

/INSTRUCTIONS INTO A LISTING WITHOUT 

/HAVING TO TYPE THEM TWO OR MORE TIMES. 

GGGGGGGG 

HHHHHHHH 

IIIIIIII 

JJJJJJJJ 

KKKKKKKK 

LLLLLLLL 

MMMMMMMM 

page eject 

$SLIP L,S 

*FII,E IN:17='TESTIN SRC' OUT : 18= ' TESTOU SRC" 
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**CHANGE** 
♦FILE IN: 15= 
1 
2 
3 
4 
5 
6 
7 
**DELETE** 
8 
9 
10 
11 
**DELETE** 
**CHANGE** 
**DELETE** 
12 
13 
14 



-'HHH',2* 
>'EXTIN SRC $ 
AAAAAAAA 
BBBBBBBB 
CCCCCCCC 
DDDDDDDD 
EEEEEEEE 
FFFPFFFP 
GGGGGGGG 
HHHHHHHH 

/THIS IS A USEFUL WAY 
/OF INSERTING OPERATING 
/INSTRUCTIONS INTO A LISTING WITHOUT 
/HAVING TO TYPE THEM TWO OR MORE TIMES. 
IIIIIIII 
-$ 

JJJJJJJJ 
KKKKKKKK 
LLLLLLLL 
MMMMMMMM 



********** SLIP COMPLETE ********** 



$LIST TESTOU SRC 

page eject 

AAAAAAAA 

BBBBBBBB 

CCCCCCCC 

DDDDDDDD 

EEEEEEEE 

FFFFFFFF 

GGGGGGGG 

/THIS IS A USEFUL WAY 

/OF INSERTING OPERATING 

/INSTRUCTIONS INTO A LISTING WITHOUT 

/HAVING TO TYPE THEM TWO OR MORE TIMES. 

KKKKKKKK 

LLLLLLLL 

MMMMMMMM 



VII-5-2 3 




CHAPTER 6 
TASK BUILDER AND BASIC TASK BUILDER: BUILDING A TASK FOR EXECUTION 



The Task Builder is an interactive program used to build user and 
system tasks from relocatable binary files. This program links the 
user's binary files to library functions to create an executedjle task. 
By responding to questions asked by the Task Builder, the user 
supplies information on run priority, core partition, COMMON block 
requirements, and other task operating characteristics. 

The Task Builder is flexible, allowing the user to build a simple 
one-program task with no overlays or very complex tasks made up of 
multiple programs (some written in FORTRAN and some written in MACRO) , 
a resident portion, and multiple overlays and suboverlays. Tasks may 
be built for a variety of execution modes with the following 
characteristics ; 

1. Uses floating-point hardware or not 

2. Runs in BANK addressing mode or in PAGE mode 

3. Runs in USER mode (protected) or EXEC mode (privileged) 

4. If in USER mode, runs in XVM mode (wide addressing) or not 

The user generates a system of overlays - a resident main program 
which may include resident subprograms, a resident blank COMMON 
storage area, and a set of subroutines which overlay each other at the 
user's request. Subroutines are organized into units called LINKs 
which may overlay each other. Several LINKs may overlay a larger LINK 
without overlaying each other. A LINK is loaded into core when a 
subroutine within the LINK is called and it remains resident until 
overlayed. A LINK'S core image is not recorded or "swapped out" when 
it is overlayed. The same image is brought into core each time a LINK 
is loaded. 

For the user who wants to build a simple Task, the flexibility of the 
Task Builder can be a nuisance. For that reason, a second version of 
the Task Builder whose task name is BTK... (Basic Task Builder) is 
provided. BTK... assumes answers to all the questions that the 
standard Task Builder, TKB.,., asks directly. Section 6.5 describes 
BTK in more detail. 

All disk-resident RSX tasks are built and incorporated in the system 
in the same way. Throughout the process, the task name is usually 
used as file name, but the extension changes. Tasks are assembled or 
compiled from source code to produce relocatable bineury (extension 
BIN) files. The bineury files (combined perhaps with other bin«iry 
files, typically library subprograms) are fed through the Task Builder 
to produce a binary task file (extension TSK) , which is one step 
closer to the executable form than BIN files. Finally, TSK files are^ 
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I read by the FININS task or the INSTALL function task, which converts 
the task file into absolute core-image form, stores it on the disk for 
rapid loading and records its existence in the System Task List, 



6.1 INVOKING THE TASK BUILDER 

The Task Builder is invoked under TDV in the following way: 



Form: 


TDV>TKBV 



Control is passed to the Task Builder, which establishes dialogue with 
the user by typing a question and a prompting character (>) , and 
expecting a response. An example of user interaction with TKB appears 
in Figure 6-1. In all cases, user responses are identified by their 
placement after the prompting character. Each TKB question is 
described in detail later in this chapter. 
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TErV>TKB 

TASK BUILDER XWM U:IA003 

LIST OPTIONS 

^-BKRfMRMrNFP 

NAME TASK 

>STA. . , 

SPECIFY DEFAULT PRIORITY 

DESCRIBE PARTITION 

DEFINE RESIDENT CODE 
>STATUS , CORE s- USERS , TASKS 
DESCRIBE LINKS 8 STRUCTURE 



ALLOC. STRATEGY J BOTTOM UP 
ACTUAL PARTITION SIZE {032000 
EFFECTIVE PARTITION SIZEJ032000 
VIRTUAL PARTITION SIZE{032000 



STATUS 000020--000724 
CORE 000725-001003 
USERS 001004-001421 
TASKS 001422-001677 
DATE. 5 SRC 001700-001737 
SPYF.l SRC 001740-001763 
.DA 015 001764-002063 

BCDIO 056 002064-006121 
STOP 008 006122-006135 
FIOPS 047 006136-007056 

DBLINT 007 007057-007455 
INTEAE 009 007456-007606 
RELEAE Oil 007607-010705 
OTSER 016 010706-011225 
SPMSG 014 011226-011355 
.CB 004 011356-011377 

.FP 000 011400-011401 

MINIMUM EFFECTIVE PARTITION SIZE t 012000 

CORE REQ'D 

000000-011401 

TDV> 



Figure 6-1 
Task Builder Session 

An altmode is a null entry. To terminate command input prematurely, 
the user should type CTRL/Q followed by a carriage return in response 
to any command output message. This causes the Task Builder to exit. 
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6.2 INPUT/OUTPUT 

The following LUN assignments should be made before the Task Builder 
is invoked under TDV: 

LUN Assignment 

10 System Library input 

11 User Library input 

12 Terminal input 

13 Terminal output 

17 Binary file input 

18 Task file output 

If eui I/O error occurs during Task Building, the following message: 

TKB - I/O ERROR LUN XX yyyyyy 

is produced on LUN-13; xx represents the Logical Unit Number (decimal) 
and yyyyyy the octal Event Variable indicating the cause of the error. 



6.3 COMPARISON WITH CHAIN AND EXECUTE DIALOGUE 

The operations of the Task Builder under RSX are very similar to those 
of the CHAIN and EXECUTE programs which run under control of DOS. 
Interaction with these programs is described in detail in the CHAIN 
XVM/EXECUTE XTTT UTILITY MANUAL. Note that all command lines logically 
terminate with an ALTMODE character. Lines terminated by a carriage 
return are continued on the next physical line; therefore, a logical 
command line may consist of several physical lines. 

User interaction with the Task Builder differs in some ways from the 
descriptions in the manual. The following sections summarize those 
components of the dialogue which remain the saune as well as those 
which differ significantly under RSX. 



6.3.1 List Options 

Any of the list, execution mode, and library options, shown in Table 
6-1 may be specified. If more than one option is included, entries 
must be separated by commas. 
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Table 6-1 
Task Builder List, Execution Mode, and Library Options 



Option 


Action 


Default 


BKR 


BANK-mode relocation 
(13-bit addressing) 


PGR 


BUFFS :n 


Reserve n decimal I/O 
buffers of 422 octal words 
each when calculating 
effective partition size 


n = 


EXM 


EXECutive mode (neither 
protection nor relocation) 


NRM 


FP 


Hardware Floating-Point 
Libreiry ( floating-point 
hardware available) 


See MFP option 


GM 


Output global symbol and 
file name in load maps 


Output program names 
in load maps 


iot' 


Allows task to issue lOT 
instructions. (Permitted 
only for USER-mode 
tasks) 


Don't allow task to 
issue lOT instruction 
unless task is any 
EXEC-mode task 


NFP 


Non-hardware Floating- 
Point Library (no float- 
ing point hardware 
available) 


In default, the FP/NFP 
option is dynamically 
determined by the 
availability of floating- 
point hardware 


NM 


No load map 


Output load map 


-•''NRM • 


USER-mode (protection 
and relotation) 


NRM 


PAL 


Pause after outputting 
each link 


No pause after out- 
putting each link 


PAR 


Pause after outputting 
resident code 


No pause after out- 
putting resident code 


PGR 


Page-mode relocation 
(12-bit addressing) 


PGR 



■XVM hardware must exist on the installation if this option is 
be used. 



to 
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Table 6-1 (Cont.) 
Task Builder List, Execution Mode, eind Library Options 



Option 


Action 


Default 


RES/name , . . . , name/ 


Force the COMMONS named 
to be part of the resident 
code and load them from 
the top of the virtual 
partition space down 


Make only those COMMONS 
declared in the resident 
code resident 


SAC 


Single allocation of 
COMMC»I blocks. 
Elements of ledjelled 
COMMONS may be ref- 
erenced by any co- 
resident link 


Elements of labelled 
COMMONS may not be 
referenced by any co- 
resident link 


SHR^ 


Some COMMON blocks 
should be allocated memory 
within Shared Addressing 
Space. Request specifi- 
cation of these COMMONS 
later in dialogue, (per- 
mitted only for USER- 
mode tasks) 


There will be no 
COMMONS allocated 
in Shared Addressing 
Space 


SL: 
name 


System Library name 
(alternate user-specified 
System Library name) 


•LIBRX (non-floating- 
point hardware) or 
.LIBFX (floating- 
point) , depending on 
choice of NFP or FP, 
respectively 


SZ 


Output size in load maps 


No size in load maps 


UL: 
neime 


User Library name 
(alternate User Library 
name) 


.LIBR5 


K^^ ) 


XVM mode or 17 -bit 
indirect addressing 
mode, (permitted only 
for USER-mode tasks) 


15-bit addressing 



1 XVf4 hardware must exist on the installation if this option 
be used. 



is to 
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6.3.1.1 PAGE Mode - Bits 6-17 of a memory-reference instruction are 

taken as an operand address, and bit 5 is used to select address 

modxfication via the Index Register (XR) . Thus 4K of core is directly 
addressable. 



6.3.1.2 BANK Mode - Bits 5-17 of a memory reference instruction are 
taken as an operand address. Thus 8K of core is directly addressable, 
but the Index Register camnot be used for address modification. 

6.3.1.3 EXEC Mode - Tasks running in EXEC mode are not restricted in 
the core they may reference or alter, or in the instructions which 
they may execute. l/o Handler and MCR Function tasks must run in EXEC 
mode. Hardware relocation is not used in this mode. Thus the 15-bit 
addressing range limits EXEC-mode tasks to partitions below 32K. If a 
2f5S!i^"® ^ °®^ "°*^ ^^^® hardware relocation, all tasks must be run in 
EXEC mode. EXEC-mode tasks are assumed to be debugged and 
well-behaved. For this reason, the system performs practically no 
checking on EXEC-mode tasks. j ^' f a^T.±c^j.±y no 

^'^l}^^ ?^^^ **°^® " '^^^ ^^ a nonprivileged mode in which a task is 
prohibited access or execution outside its partition, it may not 
dxrect the system by means cf I/O Directives or System Directives to 
alter any core partition but its own. 

The only exceptions are: 

1. USER-mode Tasks may transmit data to and receive data from 
System COMMON Blocks by using the COMMON Communicator I/O 
Handler task as an intermediary. 

2. USER-mode Tasks may transmit data to and receive data from 
System COMMON Blocks or partitions using XVM core sharing 
hardware, the SHR option, and the SHARE directive. 

3. USER-mode Tasks may access memory via the SPY and SPYSET 
directives . 

A USER-mode Task is also prohibited by the hardware from executing 
fu x^^^^^^*^^®^ instructions as HLT, lOT, OAS, or double XCT (unless 
the lOT option was specified when tlie task was built) . 

Reasonable protection is provided, but this mode should not be 
considered "idiot proof ," because a USER-mode Task is not restricted in 
issuing Directives which affect areas other than core. Such a Task 
may, for example, interfere with the scheduling of other Tasks; it 
may tie up I/O devices by attaching them indefinitely; and it may 
enter tight loops, making continued system requests that could exhaust 
the Pool of Empty Nodes. 

USER-mode Tasks are relocated to zero, and use hardware relocation and 

«S£^?^?r^ i,.°K?f^'-5f ^° ?^^®°^ memory protection. Unless XVM mode is 
specified, 15-bit addressing range limits the size of such a task's 
useful partition space to 32K. However, hardware relocation permits 
positioning of parUtions for USER-mode tasks anywhere in 12~8K 
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The protected/relocated mode is called "user" mode to emphasize the 
fact that it is the normal mode; the mode recommended for tasks, 
unless they must run unprotected. A task that is to run "protected" 
is not protected from other tasks; rather, other tasks are protected 
from it. Such protection is necessary when debugging a new task. 

Most tasks under RSX can be aborted (i.e., forced to exit). In this 
I event, I/O rundown is performed for the task. For example, if a task 
should exit, leaving some device attached and several files open on 
the disk, I/O Rundown is invoked. In effect, this detaches the device 
and closes all of the files. 

An advantage to building user-mode tasks is that their partitions can 

I be redefined without requiring that the tasks be rebuilt. All user 
tasks that run under MULTIACCESS must be built in user mode to 
preserve system integrity. 



If XVM mode as well as user mode i 
can indirectly access memory via 1 
access up to 128K if such a partit 
practice, however, the maximum pa 
wide addressing capability, the ex 
blocks** of such a task cannot ex 
highly useful if a task contains 
uninitialized COMMON blocks. The 
is the primary use of XVM mode, 
existence of XVM hardware. Us 
XM-15 option should not attempt to 



s specified for a task, that task 
7-bit addressing. Such a task could 
ion were allowed in the system. In 
rtition size is 114K*. Despite this 
ecutable code and initialized COMMON 
ceed 32K. Nevertheless, XVM mode is 
extensive code as well as large 
ability to access such COMMON blocks 
The XVM option depends on the 
ers without an XVM or PDP-15 with an 
build a task in XVM mode. 



6.3.2 Name Tasks 



The user specifies a one- to six-character task name 
task to be built. 



identifying the 



6.3.3 Specify Default Priority 

The user specifies the default priority at which a task will run. 
This is an optional parameter. It can be entered or changed when the 
task is installed. if specified, the priority must be between 1 
(highest priority) and decimal 512 (lowest priority) . If not 
specified, TKB assumes a default priority of 400. 



*Since 128K is the maximum supported core size and must include space 
for the Executive, I/O handlers and MCR partition, the maximum 
partition size is 114K. 



**COMMON blocks are initialized by block data subprograms 
and by the .CBS/.CBC/.CBE pseudo-ops in MACRO. 



in FORTRAN 
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6.3.4 Describe Partition 

The user identifies the core partition in which the task will run, 
using the form: 



Form: 



Where: 



Example: 



tname [ (size) ] ~j 
name [ (base, size) ]J 



for a user-mode task 
for an exec-mode task 



name identifies a partition that has already 

been defined 
base is the octal starting address of the 

partition 
size is the octal size of the partition 



DESCRIBE PARTITION 
>P40.0 



Typing an altmode causes the task being built to be relocated for the 
partition currently in use by the user's copy of TKB. This feature is 
available for convenience. Normally, the MULTIACCESS Monitor 
dynamically selects the partition assignment of all user-mode tasks 
executed under MULTIACCESS. 



If the partition base and size are unspecified, the named partiti 
presumed to exist in the current configuration. The Partition 
Description List (PBDL) is scanned by the Task Builder for the 
partition and the existing values of base and size are 
Alternately, if the partition does not exist in the cu 
configuration and the task is being built to run in user 
(relocated) , only the partition size need be specified; the base 
be omitted. Exec-mode tasks require both base and 
specifications. 



on IS 
Block 
named 
used, 
rrent 

mode 
can 

size 



The execution mode is not a characteristic of a given partition. 
Consequently, the user can build tasks with different execution modes 
to run within the same partition. Partitions must be a multiple of 
400 (octal) words in size. Partitions can be defined starting 
immediately above the top of the Executive. 

The size of the partition specified to TKB or the existing value of 
the partition size is called the actual partition size. This value is 
reduced by the buffer space, specified by the BUFFS option, to obtain 
what is called the effective partition size. This is the space that 
could be used by the task, assuming that it were able to address it. 
For user-mode tasks, buffer space is always rounded to the next 
highest increment of 400 (octal) words to permit effective use of the 
memory-protection/relocation hardware. The virtual partition size is 
that part of the effective partition size that the task can address. 
Usually the effective partition size is equal to the virtual partition 
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only reason the effective partition size might exceed the virtual 
partition size is if the effective partition size were greater than 
the maximum virtual partition size for a task built with a particular 
set of options. The maximum virtual partition size for a task can be 
determined from the following chart. 

Options Specified Maximum Virtual Partition Size 

EXM 32K 

NPJ4 (not XVM and not SHR) 32K 

NRM, XVM {not SHR) 12 8K 

NRM, SHR (not XVM) 24K 

NRM, XVM, SHR 120K 

The Task Builder allocates code and ccanraon blocks within the virtual 
partition space with one exception. Shared common blocks are always 
allocated memory within the shared address space {ShS) which is 
immediately eibove the virtual partition space whenever the SHR option 
is specified. 

6.3.5 Describe Systera or Shared COMMON Blocks 

If the task is being built in EXEC mode, the user will be asked to 
specify System COMMON blocks. If the task is being built in USER-mode 
and the SHR option was declared, the user will be asked to specify 
Shared CCMMON Blocks. The way in which such COMMON blocks are 
indicated is quite similar but tliere are some differences between the 
formats used to specify System or Shared COMMONS. 



6.3.5.1 Describe System COMMON Blocks 

Here the user identifies COMMON blocks which are referenced by the 
task but may be common to all tasks in RSX. These System COMMON 
Blocks are used for communication between tasks; however, a task may 
also have its own internal COMMON blocks. 

EXEC-mode tasks can indirectly access Systera COMMONS provided such 
COMMOJs lay within the first 32K of core. This is because EXEC-mode 
tasks reside within the lower 32K of memory and run unprotected^ 
EXEC-mode tasks cannot indirectly access system COMMONS which reside 
above 32K. 

Each such COMMON block is specified according to the following format: 
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Forms 


name (base, size) [,...] 


where: 


neune identifies a COMMON block which has been 
defined in RSX at System Startup time 

base is the octal starting address of the 
COMMCW block 

size is the octal meucimum size of the COMMON 
block 


Example : 


DESCPTBE SYSTEM COMMON BLOCKS 
>FLAG(36400,400) 



The user can enter as many as four COMMON block descriptions by 
inserting commas between entries. Those COMMON blocks in the user 
program which are not declared to the Task Builder to be System COMMON 
Blocks are allocated within the task's virtual partition space and are 
referenced only by that task. Blank COMMON has the name .XX. 

6.3.5.2 Describe Shared COMMON Blocks 

The user must identify those COMMON Blocks referenced by the task 
which should be allocated memory within the task's Shared Address 
Space. These COMMONS must be named and uninitialized. The physical 
memory actually accessed when the task references a word in such a 
COMMON will depend upon the state of the MM register at the time of 
the access . The I#l register will be set when the task issues the 
SHARE directive. Once the SHAKE directive has been issued with the 
correct parameters, XVH hardware will map the task's accesses to 
Shared Addressing Space (SAS) into other locations within physical 
memory. Since a task's SAS is not part of the task's virtual 
partition space, accesses to shared COMMONS prior to issuing the SHARE 
directive will cause a memory protection violation, forcing the task 
to be aborted. 

SAS is divided into Internal Shared Address Space (ISAS) and External 
Shared Address Space (ESAS) . ISAS is always 400 octal words long and 
its base is identical to the base of SAS. ESAS begins at the base of 
SAS plus 400 octal words (i.e., at the end of ISAS). The length of 
ESAS depends upon parameters given in the SHARE directive. For tasks 
not built in XVM-mode, SAS starts at word 60000 octal relative to the 
partition's base. SAS starts at word 360000 octal relative to the 
partition's base for tasks built in XVM-mode. 

When the task has issued the SHARE directive, accesses to ISAS will be 
mapped into the first 400 octal words of the task's partition. 



References to ESAS will be mapped into 
specified in the SHARE directive. 



an area of physical memory 



The use of the SHR option depends upon the existence of XVM hardware 
and the SHARE directive. If the user does not have such hardware or 
the NOXM assembly parameter was defined when the RSX executive was 
assembled, no tasks .should be built in SHR mode. 
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Each Shared COMMON Block Is specified according to one of the 
following formats: 

Form 1: name (offset, size) [,...] 

Form 2: naxae (size) [,...] 

Form 3 : name [,...] 

In these formats, name identifies a COMMON Block declared by the task. 
In Form 1, offset is added to the base of ESAS to obtain the base 
address of the COMMON named. The offset from ESAS can be negative but 
cannot cause a shared COMMON to start outside of the task's SAS. For 
example, it is possible to set the offset equal to -400 octal. This 
would cause the base of the named COMMON to coincide with the base of 
SAS. Offset and size should be specified as octal numbers. Size 
specifies the length in words, of the shared COMMON Block. Note that 
size also specifies the base address of the next shared COMMON 
relative to the base of the current shared COMMON. The only exception 
to this rule is that a specification made using Form 1 will override 
all previous specifications. The value of size must be a positive 
octal number and cannot direct TKB to allocate space for a shared 
COMMON outside SAS. Form 3 is siraply a short fonn for Form 2 with a 
size of zero, (e.g., "COM," means "COM(O),"). The use of each of 
these forms is apparent from the following example. 

Shared COMMON Definition COI'IMON Base 



COM1(-400, 1000), SAS = ESAS - 400 

COM2 (100), SAS + 1000 = ESAS + 400 

COM3, SAS + 1100 = ESAS + 500 

COM4, SAS + 1100 = ESAS +500 

C0M5 (0,200), SAS + 400 = ESAS 

COM6(100), SAS + 600 = ESAS + 200 

COM7(2000, 0) SAS + 2400 = ESAS +2000 

If forms 2 or 3 are used prior to form 1, the base of the first shared 
COMMON named is made to coincide with the base of ESAS. 

The user can enter as many shared COMMON Blocks as are declared in the 
task by inserting commas between entries. All shared COMMONS must lay 
within SAS. Those COMflON Blocks in the user's program which are not 
declared to be shared are allocated within the task's virtual 
partition wall and are referenced only by that task. Blank COMMON 
cannot be shared. 
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since the Task Builder does not allocate space for shared COMMONS 
within the task's virtual partition space, the actual size of any 
shared COMiiON is irrelevant. Hence, when calculating ih© size of a 
shared COMI-ION to be printed in load raaps, TKB assumes that its top 
address coincides with the top of ESAS. 



6.3*6 Define Resident Code 

Here the user lists the names of files containing relocatcdsle binary 
units of routines to be resident throughout a r\in and the neunes of 
library routines (flagged by librciry indicators (#)) to be resident 
throughout a run. These names are listed in the following format: 



Form: 


name [ f . . • ] 


Where: 


ncune is the name of a file or of a library 

routine (see above) to be resident throughout 
a run 


Excunple : 


DEFINE RESIDENT CODE 
>ZZZ.12,#LIB1 



RSX tramsfers initial control to the entry point of the first resident 
routine relocated, i.e., the first routine of the first file listed, 
unless resident code consists exclusively of library routines. The 
response to DEFINE RESIDENT CODE must be at least one name.' 

6.3.7 Describe Links and Structures 

Here the user describes the overlay structure in terms of LINK names. 
When a LINK is to consist of only one external component, the name of 
the file containing the external component may be used as the LINK 
ncune. However, when a LINK is to consist of more than one external 
component, the LINK must be named and defined. 

In the DOS system, the supervision of core overlays is handled by a 
system program called EXECUTE, which exists as a separate file from 
the user's XCT file built by CHAIN. In XVM/RSX, the equivalent of 
EXECUTE is a subroutine called EXU.13 (the nxunber nay vary). t-Jhenever 
the Task Builder constructs a file with overlays, it expects to find 
EXU.13 in the system library, .LIBRX or .LIBFX. If the appropriate 
library file is not present on LUN-10 when an overlay task is being 
built, an error message will be printed during the expansion of the 
resident code: 

TKB-I/O ERROR LUN 10 13 

Code 13 means that the file was not found. 
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6.3.7.1 LINK Definitions - Each LINK definition requires one line 
command input in the following format: 



of 



Form: 


(extfile[,...] [/] [intfile] [,...]) 

name = { > 

( [extf ile] !,...][/] intfile [,...]) 


Where: 


name is the name of the LINK 

extfile is the name of an external LINK 

component 
intfile is the name of eui internal LINK 

component 


Example ; 


Define the LINK named ABC to consist of 
external components SUBl and SUB2 and 
JLnternal components SUB3 cuid SUB4: 

DESCRIBE LINKS & STRUCTURES 

>ABC=SUB1 , SUB2/SUB3 , SUB 4 



A LINK definition is a list of the names of files which contain the 
relocatable binary units that comprise the LINK components. The 
individual file names listed are separated by commas ( , ) ; the two 
types of LINK components which may be used (external euid internal) are 
separated within the definition by a slash (/) . All external LINK 
component names must be listed before (to the left of) the slash 
separator; all internal LINK components must be listed after (to the 
right of) the slash. External LINK components are accepted only from 
files with names which match the external component name (i.e., GLOBAL 
symbol definition) . 



Rules for defining a LINK: 



1. 
2. 



3. 



A LINK may not be a component of another LINK. 

The names of the components of a LINK may not be used as LINK 
names. When a LINK consists of only one component, the 
component's file name may be used as the LINK name in the 
overlay structure description, but not in a LINK definition; 
i.e., it is not necessary to define a single component LINK 
but, if defined, the LINK name cannot be the component neime. 



A file neune used in the resident code description 
used in a LINK definition. 



cannot be 



4. A file name preceding a slash may be used only once. 

5. A file name following a slash may be used in other LINK 
definitions (following a slash) . 
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6.3.7.2 Overlay Structure Description - An overlay structure is 
described using the names of defined LINKS, or the names of files 
containing LINK components and the operators colon (:) and comma (,). 

This description has the following basic format: 



Form: 



Where: 



Example : 



overlaid: [. . .]overlaying[ , . . .] 



overlaid is the name of the part of the 
structure to be overlaid (a defined LINK 
or a file containing a LINK component) 

overlaying is the name of the part of the 
structure to overlay overlaid (a defined 
LINK or a file containing a LINK component) 



SUB2 overlays SUBl: 
DESCRIBE LINKS & STRUCTURES 
SUB1:SUB2 



The following rules apply: 

1. A line is eui independent statement 
right. 



processed from left to 



2. A colon signifies "is overlayed by.' 
loading order, is implied. 



Core mapping, but no 



3. A comma signifies "and." The following: 

SUB1:SUB2 
SUB2:SUB3,SUB4 

indicates that SUBl is overlayed by (uses the same core as) 
SUB2, SUB2 is overlayed by SUB3 and SUB4, but SUB3 and SUB4 
do not overlay each other. 

4. A colon operator may not be used in a line after a comma has 
been used. This restriction prevents the following 
ambiguity : 

SUB2 :SUB3 ,SUB4 :SUB5 

The above line is rejected because it is not clear whether 
SUBS overlays SUB3 or SUB4 or both. All four of the 
following examples are acceptable: 



SUB2:SUB3,SUB4 
SUB 4: SUBS 



SUBS uses the same core as 
SUB 4 but not the same core 
as SUB 3. 



SUB2:SUB3,SUB4 
SUB3:SUB5 



SUBS uses the same core as 
SUB 3 but not the same core 
as SUB4. 
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SUB2:SUB5:SUB3,SUB4 SUBS uses the same core as 

SUB3 and SUB4. SUB3 and 
SUB4 are loaded individu- 
ally (if nonresident) as 
called. 

LINK=SUB3,SUB4 SUBS uses the same core as 

SUB2: LINK: SUBS SUB3 and SUB4. Both SUB3 

and SUB4 are loaded (if 
nonresident) whenever 
either is called. 

5. A LINK neune may appear only once preceding a colon and only 
once following another colon. 

6. If a LINK name is used twice, it must be used following a 
colon before being used before another colon. 

7. Several LINKs overlaying each other may be defined in one 
statement, as in the following: 

SUB1:SUB2:SUB3,SUB4 Core mapping, but no 

loading order, is implied. 
This is a short method of 
defining the same overlay 
structure as in the first 
exaunple, under rule 3. 

Although rules 5 and 6 may appear restrictive, they do not limit the 
user's description of cui overlay structure, but do prevent multiple 
description of the position of a LINK in an overlay structure, A LINK 
may be both overlayed and overlaying, and it may not be possible or 
convenient to describe both conditions by using the LINK name only 
once, as follows: 

SUB1:SUB2:SUB3 SUB2 is overlaying SUBl and is overlayed 

by SUB3. 

Therefore, when a LINK is both overlaying and overlayed, its LINK name 
may be used twice, but the LINK(s) overlayed by it must be described 
before the LINK(s) by which it is overlayed, as follows: 

SUB2:SUB3,SUB4 SUB3 overlays SUB2, 

SUBS: SUBS SUB3 is overlayed by SUBS, 

NOTE 

The description of an overlay structure 
only defines a desired core mapping; 
i.e,, stating that SUBl is overlayed by 
SUB2 means that both eire to be relocated 
to the same core auid cannot cores ide, 
but does not imply that SUBl must be 
called before SUB2. There is no imposed 
order in which routines must be called, 
nor is there restriction of the routines 
callable by any routine. 
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6.3.8 Completion of Dialogue 

After all of the previously described characteristics have been 
supplied by the user and accepted by TKB, the program computes the 
amount of core required by the task and prints it in the format: 
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Form: 



start-end size 



Where; 



Example; 



start is the octal starting address of the task 
in the core partition identified above 

end is the last filled octal location in this 
partition 

size is the octal size of the task 



CORE REQ'D 

40000-46266 06267 



TKB terminates interaction with the user by returning control to the 
MULTIACCESS Monitor. When in control, the Monitor requests another 
function by typing: 

TDV> 



6.4 CONVERSION TO XVM/RSX 

XVM/RSX user interaction with the Task Builder differs from 
interaction with previous versions of the Task Builder. All user 
FORTRAN programs developed under previous versions of RSX must be 
recompiled and rebuilt by the Task Builder to enable them to run under 
XVM/RSX. Similarly, assembly language programs should be reassembled 
and rebuilt for XVM/RSX operation. 



6.5 BTK: BASIC TASK BUILDER 

BTK, the Basic Task Builder, closely resembles TKB, but requires 

different input. BTK is useful for building simple tasks, 

particularly for batch-processing. BTK is invoked in the following 
way: 



Form: 



Where; 



Example: 



BTK name [, name. . .]V 



name is the name of the task to be built 



TDV>BTK SCAN,SCSUB 



BTK assumes the following options and conditions (refer to Table 6-1) : 

NRM 

FP or NFP 

PGR 

priority of 400 

TDV partition 

The resident code that has been entered 

BTK generates a load map. As an aid to the system, the batch handler 
removes trailing spaces from card images passed to the MULTIACCESS 
Monitor . 
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6.6 ERKOR MESSAGES 

Tables 6-2 and 6-3 list possible error messages emd their 

implications. Messages regarding command string errors immediately 

follow the erroneous logical line. The command is ignored and must be 
retyped. 

The > prcnnpt follows the message if the error is recoverable. When 
possible, the faulty character or name is output after the error 
message. If the error is not recoverable, TKB exits to TDV after 
typing the message. 

Below is a sample sequence of miscellaneous recoverable errors: 

TDV>iKB 

TASK BUILDER XVM Ul AOOO 

LIST OF'TIONS 

>BAF^f3Z 

"- UN FiE COGNIZED SYMBOL BAR 

";;. i"^ "}' 

NAME TASK 

';:■ P '? 

SPECIf-Y DEFAULT F^'RIORITY 
>600 

"- IMPROPER PRIORITY 

SPECIFY DEFAULT' PRIORITY 

>S00 

DESCRIBE PARTITION 

>BLK1" PARTITION NOT IN SYSTEM 

>-BLK 

DEFINE RESIDENT CODE 

!>f-':L/F2 

'" IMPROPER BREiiAK CHAR / 

>F:i. pF2 

DESCRIBE LINKS S SFRiJCTURE 

>LKi# = 3UBl/Br!TA 

LIB 1 ND ON 1... INK NAME LKl 

EXTERNAL NAME uSi:::D PRV -■• F'2 
>LKI~SUBi/'LBDTA 

>• L. K 2 "- S U B 2 / i... B D i ■ A / ;■> Li B X 

-■ IMPROPER BREAK CHAR / 

>LK2-~SUB2/LBDTA 

>LK1 JLK2SF1 

RES ROUTINE NAMI:- USED AS I TN!< NAHF e-'1 

>LKi;LK2 
>LK:i. ILK45£. 

NAME USED LEFT OF COLON TWICE LKl 
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Table 6-2 
Messages Produced by Becoverable TKB Errors 



Error Message 



Meaning 



•hUNRECOGNIZABLE SYMBOL 

-hRES ROUTINE REQ'D 

+LINK NAME USED PRV 

fNAME LENGTH ERR 

+ IMPROPER BREAK CHAR 

-MNTERNAL NAME REPEATED IN LINE 
+ EXTERNAL NAME USED PRV 

t COMPONENT NAME USED AS LINK NAME 

+LINK DEF WITHIN OVERLAY 
DESCRIPTION 

fCOLON MUST FOLLOW FIRST 
LINK NAME 

+MORE THAN ONE LINK OVERLAYED 

+NAME RIGHT OF COLON USED PRV 

'hNAME USED MORE THAN TWICE 
+NAME USED LEFT OF COLON TWICE 

fLIB IND ON LINK NAME 

^INTERNAL NAME USED PRV 

+RES ROUTINE NAME USED AS LINK NAME 

+NAME USED MORE THAN ONCE 

INCONSISTENT OPTION 



Unrecognizable symbol in 
command string 

No resident routine has been 
declared 

Name used previously 

Legal name has 1-6 characters 

Break character used incor- 
rectly 

Internal LINK component name 
used more than once within 
LINK 

External LINK component name 
used previously within overlay 
system 

Name of LINK component used a s 
name of a LINK 

LINK definition within overlay 
description 

Colon missing after first LINK 
name 

More than one LINK overlayed 

LINK name used more than once 
to right of colon 

LINK name used more than twice 

LINK name used more than once 
to left of colon 

Library indicator (#) on LINK 
name 

Internal name used before 

Name of resident routine used 
as LINK name 

LINK name used more than once 

The option specified is 
incompatible with other 
declared options. 
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Table 6-2 
Messages Produced by Recoverable TKB Errors 



Error Message 



IMPROPER PRIORITY 



"PARTITION STARTS ABOVE 32K 



PARTITION ENDS ABOVE 32K 



"TOO MANY DEFINITIONS 



PARTITION NOT IN SYSTEM 



ILLEGAL SIZE 



LIB IND ON EXTERNAL NAME 



LIB IND ON INTERNAL NAME 



'COMMON OUT OF SAS 



Meaning 



The specified priority is out 
of range (greater than 512) 

The partition for an exec-mode 
task starts above 32K 

The partition for an exec-mode 
task ends above 32K 

The amount of table space in 
free core is exceeded for user 
information 

The specified partition does 
not exist in the system 

The partition size is not a 
multiple of 400 (octal) words 

The user has incorrectly 
applied the library indicator 
to an external name 

The user has incorrectly 
applied the library indicator 
to an internal name 

The common block specified is 
larger than the shared address 
segment and cannot be 
addressed 



XVM/RSX VIB 



VII-6-20.1 



September 1976 



Table 6-3 
Messages Produced by Unrecoverable TKB Errors 



Error Messages 



TABLE OVERLAP 



READ ERROR 



ILLEGAL LOADER CODE 



LABELED COMMON BLK SIZE ERR~ 



UNRESOLVED GLOBAL (S): 



ABS PROG 



MISSING GLOBAL OEF 



DUPLICATE GLOBAL DEF 



TASK IS LARGER THAN PARTITION 



TKB-PARTITION TOO SMALL 



TOO MANY BUFFERS SPECIFIED 



CORE OVERFLOW 



MODULE TOO LARGE — 



Meaning 



Patch table and symbol table 
overlap occurred during 
relocation of resident code 
and links to the TSK file 

An error occurred on the input 
device 

The input file contains 
unrecognizable loader code 

The labeled common block is 
now declared larger than in a 
previous declaration. The 
block name follows the 
message. 

One or more global symbols are 
unresolved during relocation 
of the resident code and links 
to the TSK file. The system 
generates a list of all 
unresolved globals. 

.ABS programs are not allowed, 
because they are not 
relocatable 

A global definition is 
missing. The system lists it. 

There is a duplicate global 
definition. The system lists 
it. 

The task is too large for its 
partition 

The specified partition cannot 
run the job 

The described buffer space 
exceeds the partition size 

The executable code portion, 
including initialized common 
blocks of the overlay 
structure defined by the user, 
does not fit into available 
core 

The named module is larger 
than 4K for page mode or 8K 
for bank mode. The module 
name follows the message. 

(Continued) 
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Table 6-3 (Cont.) 
Messages Produced by Unrecoverable TKB Errors 



Error Messages 


Meaning 


COMMON BLOCKS DECLARED RESIDENT 


A resident module has been 
specified with the same name 
as a common block 


ABSOLUTE LOAD ADDRESS 


A module has been read that 
has an absolute starting 
address 


GLOBAL SYMBOL TOO BIG — 


The user has attempted to 
reference an area beyond the 
scope of the given symbol. 
The symbol follows the 
message. 


ILLEGAL ATTEMPT TO INITIALIZE 
COMMON BLOCK — 


The user has attempted to do 
one of the following: 




1. Initialize a common block 
that is part of another 
link 




2. Initialize a common block 
that has been declared 
with the RES option 




3. Initialize a shared common 
block 




4. Initialize a system common 
block 


*** BLOCK DATA SUBROUTINE — 


A block data subroutine has 
been encountered. The 
subroutine name follows the 




message. 


COMMON BLOCK TOO BIG — 


The user has attempted to 
allocate a common block larger 
than 77777. The block name 
follows the message. 
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CHAPTER 7 
FILE INPUT, DECK, FILE OUTPUT, LIST AND TYPE 



The FILE INPUT, DECK, FILE OUTPUT, FILE LIST and TYPE TDV Function | 
tasks transfer sequential-access files from one device to another. 
The four tasks are built and invoked in identical fashion. They 
differ only in their assignment of LUNs for I/O. They perform the 
following operations: 

. FILE INPUT (FIN) transfers a sequential file from LUN-19 to 
LUN-17 

. DECK (DEC) transfers a sequential file from LUN-14 to LUN-17 

. FILE OUTPUT (FOU) transfers a sequential file from LUN-17 to 
LUN-19 

. FILE LIST (LIS) transfers a sequential file from LUN-17 to 
LUN-16; a line printer or some other printing device 

. TYPE (TYPE) is identical to LIS, but outputs data to LUN-13 | 

These function tasks can also be invoked in batch mode. 

The most common use for these functions is for backup and restoration. 
FOU is often used to backup a disk file on DECtape and sometimes on 
magtape or paper tape. FIN is used to restore the copied file to 
disk. LIS usually dumps a file from disk to the line printer. DEC is 
usually used during batch operations to transfer a file from LUN-14 
(normally assigned to the card reader) to LUN-17 (normally assigned to 
a disk). It is possible to use FIN, DEC, FOU, LIS and TYPE for any I 
copy function, simply by reassigning LUNs. 
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7.1 INVOKING FIN, DEC, FOU , LIS AND TYPE 

FIN, DEC, FOU, LIS and TYPE are invoked according to the same format: 



Form: 




[9] [option[ ,]...] name [ept][,.,]v 



Where: 



9 preceding the first space character 

signifies 9-track magtape operation. In 
its absence, 7-track operation is assumed. 

option is a one-character symbol: N or F. N 
specifies no parity check; F allows form feeds 
in the output (see the following paragraphs 
for more information) . 
The option characters can be either 
concatenated or separated by commas. 

name is a string of one to six .SIXBT 

characters and represents the input file. 
At least one name must be supplied. 

ext is a string of one to three .SIXBT 

characters and identifies a file extension. 
It is optional. SRC is the default. 



Example: 



Copy a binary file from DECtape (LUN-19) to 

disk (LUN-17): 
TDV>FIN SCAN BIN 

Make no parity check on the file NOCHEK SRC, 
but perform parity checking on CHECK SRC 
and CHECK2 SRC: 

TDV>FIN NNOCHEK, CHECK, CHECK2 SRC 

Insert form feeds in the output for the files 
FORMAT SRC, F0RMT2 SRC, and F0RMT3 SRC, but 
not for NOFMT SRC: 

TDV> LIS F FORMAT, FORMT 2, NOFMT, FFORMT 3 

Perform parity checking, but not formatting, for 
NOFMT SRC, N0FMT2 SRC and N0FMT3 SRC 
(A is ignored as an illegal option letter) : 

TDV>LIS NOFMT, N0FMT2,AN0FMT3 



The options N and F are entered by typing either or both option 
letters followed by the file name, and so on. When the back-arrow 
appears with no preceding option characters, it is assumed that these 
options are not to be used. Because the characters space, comma and 
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back-arrow are treated as delimiters in the command string, they 
cannot be used in file names even though they are part of the .SIXBT 
character set. 

The N option suppresses the typeout of parity error messages (N stands 
for "no parity check"). It is used to allow input of nonstandard 
paper tapes by using the RSX paper tape reader handler task PR..... 

The F option allows form feeds to be inserted in the output at 
expected locations. The purpose is to format FORTRAN and MACRO 
language source programs on the output listing device. The F option 
has no effect on binary files. A form feed is inserted after every 
line that contains an .EJECT optionally preceded by any number of 
spaces and horizontal tabs. A form feed is inserted prior to every 
line containing a .TITLE optionally preceded by any number of spaces 
and horizontal tabs. Finally, a form feed is inserted after every 56 
lines of text following the last form feed. 

Files with extensions of BIN or TSK are transferred in lOPS binary 
data mode. All others are transferred in lOPS ASCII mode. Image mode 
files are not supported. 

$DECK causes Batch to read all lines following it and preceding $EOF. 
It resembles a FIN function task, because it performs transfers of 
data, FORTRAN programs and so forth to disk. It can transfer anything 
but a job file. The sequence below is legal: 

$DECK namel, name 2, name 3 

$EOF 

$EOF 

$EOF 



7.2 INPUT/OUTPUT AND TASK BUILDING 

The FILE INPUT, DEC, FILE OUTPUT, FILE LIST and TYPE TDV Function 
tasks are assigned task names FIN..., DEC..., FOU..., LIS... and 
TYP..., respectively, at task-building time. These tasks can be built 
to run in either user mode (protected and relocated) or exec mode. 
All of these tasks expect LUN-13 (recommended dedicated terminal) to 
receive error messages and expect the following LUNs as file devices: 



Task 
Name 


Input 
LUN 


Recommended 
Input Device 


Output 
LUN 


Recommended 
Output Device 


FIN... 


19 


DEC tape 


17 


Disk 


FOU . . . 


17 


Disk 


19 


DEC tape 


LIS.. . 


17 


Disk 


16 


Line printer 


DEC . . . 


14 


Card reader 


17 


Disk 


TYP . . . 


17 


Disk 


13 


Terminal 
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For all three Tasks, if the input device has a directory, a SEEK is 
invoked to open a file for input. If not, an ATTACH is issued to 
obtain exclusive control of the device. Similarly, if the output 
device has a directory, ENTER opens a file for output; if not, cui 
ATTACH is issued. If several files are being treuisf erred, 
ATTACH-DETACH is done for each file, to allow a higher-priority Task 
to use the device if necessary. 

If the output device is a line printer or terminal, a page eject is 
performed before each file is trsmsf erred. If the input device is a 
terminal, a check is made for end-of*-file by examining the first word 
of the input line for CTRL/D followed by ALTMODE or carriage return. 



7.3 MAGTAPE OPERATION 

Since the software cannot determine dynamically whether a tape drive 
is 9-track or 7-track, 7-track operation is assumed unless the user 
specifies a 9 in the appropriate place in the command line. 

The following FORMAT parameters are issued for the different data 
modes : 



Mode 



Parameters 



9-track ASCII 
9-track BINARY 

7-track ASCII 
7-track BINARY 



9-track; 800 BPI; odd parity 
9-track; 800 BPI; odd parity; 

core-dump mode 
7-track; 800 BPI; even parity 
7-track; 800 BPI; odd parity 



Data cannot be transferred from a 7-track drive to a 9-track drive, or 
vice versa, without using the disk as an intermediary. 

Whenever end-of-tape is encountered after a READ, WRITE, or WRITE 
END-OF-FILE, the tape is dismounted (REWIND followed by a SPACE 
FORWARD RECORD) and the following messages cire printed (example is for 
tape unit 3) ; 

FIN-DISMOUNT MT3 
FIN-THEN, "RESUME FIN..." 

As soon as tape motion has stopped cuid the message printouts have 
ended, the function (FIN... in this case) suspends itself. This 
allows the operator to unload the tape manually and mount a 
continuation tape at the load point if desired. When the new tape is 
ready, the operator must resume the indicated Task. If no 
continuation is desired, he must abort the file transfer function. 
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7.4 ERROR MESSAGES 

Table 7-1 lists possible error messages and their 
messages cure printed in the following format: 

TDV>PIN string 

FIN-message 

TDV> 



implications. All 



In the eibove example and in Tcible 7-1, FIN can be replaced by FOU 
LIS. All messages are applicable to the three Tasks. 



or 



Table 7-1 
FILE INPUT, OUTPUT, and LIST Error Messages 



Error Message 


Meaning 


System Action 


FIN-LINE TOO LONG 


Commcind string exceeds 
permissible length 
(75 characters) 


Commsmd ignored 


FIN-SYNTAX ERROR 


Violation in command 


Remainder of command 




string formation 


ignored ; because some 
files may have been 
trcinsf erred, the user 
should request a 
DIRECTORY LIST 


FIN-HINF ERROR 


Input or output device 
Handler does not per- 
form HINF Directive; 
possible that nothing 
is assigned to the 
input or output LUN 


Command ignored 


FIN-NOT INPUT DEV 


I/O Handler assigned 
to input LUN cannot 
perform input; assign- 
ments should be checked 


Command ignored 


FIN-NOT OUTPUT DEV 


I/O Handler assigned 
to output LUN cannot 
perform output; assign- 
ments should be checked 


Commcmd ignored 


FIN-FILE NOT FOUND 


One of the specified 


Remainder of command 




files cannot be found 


ignored ; because some 




in the file directory 


files may have been 
tr ems f erred, the user 
should request a 
DIRECTORY LIST 



(Continued on next page) 
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Table 7-1 (Cont.) 
FILE INPUT, OUTPUT, and LIST Error Messages 



Error Message 


Meaning 


System Action 


FIN-SEEK ERR 


Error (other than FILE 


Remainder of command 




NOT FOUND) occurred 


ignored; because some 




while SEEK Directive 


files may have been 




was being processed 


trsuisf erred, the user 
should request a 
DIRECTORY LIST 


FIN-ATTACH ERR 


ATTACH Directive to the 
input or output device 
rejected (ATTACH is not 
issued to a directoried 
device) ; error might 
occur in the unlikely 
event that the input or 
output LUN was reassigned 
to euiother device before 
completion of the transfer 


Command ignored 


FIN-ENTER ERR 


Error occurred while 


Remainder of commeuid 




ENTER Directive was 


ignored; because some 




being processed 


files may have been 
transferred, the user 
should request a 
DIRECTORY LIST 


FIN-READ ERR 


Error (other than 


Remainder of command 




PARITY, CHECKSUM, or 


ignored; because some 




BUFFER OVERFLOW) oc- 


files may have been 




curred while READ 


transferred, the user 




Directive was being 


should request a 




processed 


DIRECTORY LIST 


FIN-PARITY ERR 


Parity error exists some- 


File transfer continues 




where within the device 


after printing error 




block (usually 256 words) 


message; file probably 




from which the last input 


contains altered data 




record was read 


as a result of this 
error 


FIN-CHECKSUM ERR 


CHECKSUM error exists 


File treuisfer continues 




in data record just read 


after printing error 
message; file contains 
altered data as a 
result of this error 


FIN-BUF OVERFLOW 


Record leurger than 68 


Only a partial record 




words (including header) 


is written; file trans- 




encountered in input 


fer continues after 
printing error message 



(Continued on next page) 
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Table 7-1 (Cont.) 
PILE INPUT, OUTPUT, and LIST Error Messages 



Error Message 



Meaning 



System Action 



FIN-WRITE ERR 



FIN-CLOSE INPUT 
ERR 



FIN-CLOSE OUTPUT 
ERR 



FIN-DETACH ERR 



FIN-FILE STILL 
OPEN 



PIN-DISMOUNT MT3 
FIN-THEN, "RESUME 
FIN. . . " 



FIN-WRITE EOF ERR 



Error occurred while 
WRITE Directive was 
being processed 



Error occurred while 
CLOSE Directive on 
input file was being 
processed 



Error occurred while 
CLOSE Directive on 
output file was being 
processed 



DETACH Directive issued 
to the input or output 
device was rejected 
(DETACH is not issued 
to a directoried device) 

Some other Task is ref- 
erencing the file in a 
manner that conflicts 
with the current re- 
quest 



End-of-tape reached 
during Magtape READ, 
WRITE, or WREOF 



Error occurred while 
writing an end-of-file 
mark on Magtape 



Remainder of commauid 
ignored; because some 
files may have been 
trjuisf erred, the user 
should request a 
DIRECTORY LIST 

Remainder of commemd 
ignored; because some 
files may have been 
transferred, the user 
should request a 
DIRECTORY LIST 

Remainder of command 
ignored; because some 
files may have been 
transferred, the user 
should request a 
DIRECTORY LIST 

Remainder of command 
ignored 



Remainder of command 
ignored; because some 
files may have been 
t rein f erred, the user 
should request a 
DIRECTORY LIST 

Task is suspended until 
restimed after a new 
tape is mounted or 
until aborted 

Remainder of commcUid 
ignored; because some 
files may have been 
transferred, the user 
should request a 
DIRECTORY LIST 
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CHAPTER 8 
DELETE: DELETING A PILE FROM DISK 



The DELETE FILE TDV Ftmction Task is used to DELETE files from disk. 
It can be invoked in batch mode. 



8.1 INVOKING DELETE FILE 

The user can invoke DELETE FILE by typing a command according to the 
following format: 



Form: 



Where; 



Examples ; 



DELIETE] name[ ext][,name[ ext]...]v 



neune of file DELETEd is a string of one to six 
.SIXBT characters; if more than one name is 
included, the entries must be separated by 
commas 

ext is a string of one to three .SIXBT 

characters and identifies a file extension; 

SRC is the default extension 



TDV>DELETE FILE 

TDV>DEL Fl,F2,F3 

TDV>DEL F1,F2 003,P3 BIN,F4 SRC 

TDV> 



8.2 INPUT/OUTPUT AND TASK BUILDING 

The DELETE FILE TDV Function Task is assigned Task name DEL... at 
Task-Building time. This Task can be built to run in either USER 
(protected emd relocated) or EXEC mode. It expects LUN-13 
(reconanended dedicated terminal) to receive error messages euid LUN-17 
(normally disk) as the file device. 



8.3 ERROR MESSAGES 

Table 8-1 lists possible error messages and their 
messages are printed in the following format: 

TDV>DEL 

DEL-message 

TDV> 



implications. All 
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Table 8-1 
DELETE FILE Error Messages 



Error Message 


Meeuiing 


System Action 


DEL-LINE TOO LONG 


Commcind string exceeds 
pexrmi ssible length 
(75 characters) 


Command ignored 


DEL-SYNTAX ERR 


Violation in coininjind 
string formation 


Remainder of commcuid 
ignored; because some 
files may have been 
DELETEd, the user 
should request a 
DIRECTORY LIST 


DEL-FILE NOT FOUND 


One of the specified 
files cannot be found 
in the file directory 


Remainder of command 
ignored; because some 
files may have been 
DELETEd, the user 
should recfuest a 
DIRECTORY LIST 


DEL-DELETE ERR 


DELETE Directive re- 
jected; possible that: 

1. no I/O Handler as- 
signed to proper 
LUN 

2. I/O Handler does 
not perform DELETE 

3. disk hardware er- 
ror occurred 


Remainder of command 
ignored; because some 
files may have been 
DELETEd, the user 
should request a 
DIRECTORY LIST 


DEL-FILE STILL OPEN 


Scxne other Task is 
referencing the file 
in a manner that con- 
flicts with the cur- 
rent request 


Remainder of command 
ignored; because some 
files may have been 
DELETEd, the user 
should request a 
DIRECTORY LIST 
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CHAPTER 9 
RENAME: RENAMING A FILE STORED ON DISK 



The RENAME TDV Function Task is used to RENAME files stored on disk. 
It can be invoked in batch mode. 



9.1 INVOKING RENAME FILE 

The user can invoke RENAME FILE by typing a command according to the 
following format: 



Form: 



Where: 



Examples : 



(new [newextl ) 
RENfAME] Old [oldext] ,\ [new] newext/ ^ 



old is a string of one to six .SIXBT 
characters and represents the old name of 
the file 

oldext is a string of one to three .SIXBT 
characters and identifies the old file 
extension; SRC is the default extension 

new is a string of one to six .SIXBT 
characters and represents the new name of 
the file; old is the default 

newext is a string of one to three .SIXBT 
characters and identifies the new file 
extension; oldext or its default (SRC) is 
the default 



TDV>RENAME FILE1,FILE2 
TDV>REN OLDFIL SRC,NEWFIL 003 
TDV>REN OLDFIL 002, 003 
TDV>REN OLDFIL BIN,NEWFIL 
TDV> 



Either a new name or a new extension is required. 
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9.2 INPUT/OUTPUT AND TASK BUILDING 

The RENAME FILE TDV Function Task is assigned Task name REN... at 
Task-Building time. This Task can be built to rxin in either USER 
(protected and relocated) or EXEC mode. It expects LUN-13 
(recommended dedicated terminal) to receive error messages and LUN-17 
(disk) as the file device. 



9.3 ERROR MESSAGES 

Table 9-1 lists possible error messages auid their 
messages are printed in the following format: 



implications. All 



TDV>REN string 

REN-message 

TDV> 



Table 9-1 
RENAME FILE Error Messages 



Error Message 



REN-LINE TOO LONG 



REN- SYNTAX ERR 



REN-FILE NOT FOUND 



REN-CAN 'T RENAME 



REN-RENAME ERR 



REN-FILE STILL OPEN 



Meaning 



Command string exceeds 
permissible length (75 
characters ) 

Violation in command 
string formation 

Specified file cannot 
be found in the file 
directory 

I/O Handler does not 
perform RENAME (only 
for disk Handlers) 

Error occurred while 
file being opened or 
closed; disk hardware 
error possible 



Some other Task is ref- 
erencing the file in a 
manner that conflicts 
with the current request 



System Action 



Command ignored 



Command ignored 



Command ignored 



Command ignored 



Command ignored 
(there is a remote 
chance that RENAME 
was performed if disk 
error occurred while 
rewriting UFD block) 

Command ignored 
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CHAPTER 10 
DIRECTORY LIST: LISTING FILES IN DISK DIRECTORY 



The DIRECTORY LIST TDV Function Task is used to list all files in a 
file directory on RF DECdisk, RK cartridge disk, or RP disk pack. 
These may be either sequential or rcUidom-access files. 

This Function Task can be invoked in batch mode. 



10.1 INVOKING DIRECTORY LIST 

The user can invoke DIRECTORY LIST by typing a conmicmd according to 
the following format; 



Form: 


DIR[ECTORY LIST] Rmn<UFD> 7 


Where: 


m is F, K, or P and represents the type of 
disk: RF DECdisk, RK cartridge disk, or RP 
disk pack respectively 

n represents the unit number of the disk 

UFD is the name of the user file directory 


Example : 


TDV> DIR RK2<ABC> 
3027 USER BLOCKS 
6361 FRRF, BLOCKS 

PILE RND 426 20 3-AUG-71 1000 10 
TASKOl BIN 446 3 18-AUG-71 
DIRECT 008 2-SEP-71* 



In the cibove example, the number of user blocks is the eunount of 
storage already allocated on the disk. The number of free blocks is 
the amount of storage available to the user. Each of the next output 
lines has the following components: 
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File name: One to six characters 

File Name Extension: One to three characters 

Starting Block Number: One- to six-character octal niimber CO 
if sequential-access file is truncated) 

File Size (Number of Blocks) : One- to six-character octal 
number (0 if sequential-access file is truncated) 

File Creation Date: In form day-month-year where day and year 
have one or two decimal digits 

Trimcation Hark: Asterisk if file is truncated. Truncation 
usually indicates a file in the process of being created but 
occasionally identifies one that was never properly closed. 
The latter might occur as the result of a disk hardware error. 
"Trvincation" applies only to sequential-access files. 

Random-Access Information: Two one- to six-character octal 
numbers of accounting information are supplied if it is a 
random-access file. If the file was created using the FORTRAN 
CALL DEFINE statement, these numbers represent the number of 
records in the file and the record size, respectively. If the 
file was created using MACRO, the user determines the meaning 
of these numbers. 

Bit in the second word is to indicate a BINARY 
(unformatted) file or 1 to indicate an ASCII (formatted) file. 



10.2 INPUT/OUTPUT AND TASK-BUILDING 

The DIRECTORY LIST TDV Function Task is assigned Task name DIR... at 
Task-Building time. This Task can be built to run in either USER 
(protected and relocated) or EXEC mode. It expects LUN-13 
(recommended dedicated terminal) to receive error messages, LUN-16 to 
accept the file listing, and LUN-1 for the Multi-Disk Driver Task. 



10.3 ERROR MESSAGES 

Tcible 10-1 lists possible error messages and their implications. All 
messages are printed in the following format: 

TDV>DIR 

DIR-message 

TDV> 
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Table 10-1 
DIRECTORY LIST Error Messages 



Error Message 



Meaning 



System Action 



DIR-ATTACH ERR 



DIR-NOT A LISTING 
DEV 



DIR-DISK ERR 



DIR-PRINTOUT ERROR 



DIR-DETACH ERR 



DIR-EMPTY 



DIR-UFD DOES NOT EXIST 



DIR-TDV ERROR 



DIR-PORMAT ERROR 



DIR-NON-EXISTENT DISK 



DIR-DEVICE IS NOT A 
DISK 



ATTACH Directive to the 
listing device re- 
jected; possible that 
nothing is assigned to 
the listing LUN 

HINF function indicates 
that the device assigned 
to the listing LUN is 
not a listing device 
(i.e., it cannot per- 
form output or it has a 
directory) 

Attempt to read in a UFD 
block failed; possible 
disk hardware malfunction 

WRITE to the listing de- 
vice declared to be in 
error; error does not 
occur without drastic 
cause (e.g., exhausting 
Pool of Empty Nodes) 

DETACH Directive to the 
listing device declared 
to be in error; error does 
not occur unless operator 
reassigns listing LUN in 
midstream 

No files in the file 
directory 

The UFD specified is not 
listed in the disk's MFD 
(Master File Directory) 

DIR... could not read the 
TDV command string 

Format error detected in 
command string 

Disk specified in commamd 
string is logically not 
present 

Device ncime typed was 
not RF, RK, or RP 



Command ignored 



Command ignored 



Printing of 
DIRECTORY ceases 



Printing of 
DIRECTORY ceases 



Command ignored 



Commfund ignored 



Coinmand ignored 



Command ignored 



Commctnd ignored 



Commcind ignored 



Ccmmiand ignored 
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CHAPTER 11 
DECTAPE DIRECTORY: LISTING FILES IN DECTAPE DIRECTORY 



The DECTAPE DIRECTORY LIST TDV Function Task is used to list all files 
recorded in the file directory of a DEC tape in standard format. 



11.1 INVOKING DECTAPE DIRECTORY LIST 

The user can invoke DECTAPE DIRECTORY 
according to the following format: 



LIST by typing a command 



Form: 


DTD[IRECTORY LIST] V 


Example : 


TDV>DTD 
DECTAPE UNIT 4 
31-DEC-71 
1004 FREE BLKS 
3 USER FILES 
10 SYSTEM BLKS 






FILNAM EXT 1 


15 




TABLE BIN 2 


23 




DTD.l SRC 3 


24 




TDV> 





DTD prints out the following: 

. DECtape Unit Number 

. Today's Date: In form day-month-year where day euid year have 
one or two decimal digits 

. Free Blocks: Number of free blocks in the file directory in 
octal format 

, User Files: Number of user files in the file directory in 
octal format; this is equivalent to the number of files listed 
below; system tapes consist of user files cUid system files; 
both are listed, but system files are not included in the count 
of user files 

. System Blocks: Number of system blocks in the file directory 
in octal format; the minimum number of system blocks is 10 
octal; system blocks include blocks occupied by the file 
directory (blocks 71 through 100 octal) and system files (none 
if tape initialized and written under RSX control) 
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Each of the next output lines has the following components: 

. File name: One to six characters 

. File name Extension: One to three characters 

. Starting Block Number: one- to six-character octal number 

. File Size (Number of Blocks) : One- to six-character octal 
number (0 if system file, not user file) 



11.2 INPUT/OUTPUT AND TASK BUILDING 

The'DECTAPE DIRECTORY LIST TDV Function Task is assigned Task name 
OTD... at Task-Building time. This Task can be built to run in either 
USER (protected emd relocated) or EXEC mode. It expects LUN-13 
(recommended dedicated terminal) to receive error messages, LUN-13 to 
accept the file listings, and LUN-19 for DECtape input. 



11.3 ERROR MESSAGES 

Table 11-1 lists possible error messages and their implications. All 
messages are printed in the following format: 

TDV>DTD 

DTD-message 

TDV> 
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Table 11-1 
DECTAPE DIRECTORY LIST Error Messages 



Error Message 


Meaning 


System Action 


DTD-ATTACH ERR 


ATTACH Directive rejected; 
possible that proper I/O 
Handler not assigned to 
the input or listing LUNs 


Ccanmand ignored 


DTD-NOT A LISTING DEV 


HINF function indicates that 
the device assigned to the 
listing LUN is not a listing 
device (i.e. , it cannot 
perform output or it has a 
directory) 


Command ignored 


DTD-NOT DECTAPE 


Input LUN not assigned to 
the DECtape HeUidler 


Commeuid ignored 


DTD-DECTAPE ERR 


Attempt to read in one of 
the DECtape directory 
blocks failed 


Conmiand ignored 


DTD-PRINTOUT ERR 


WRITE to the listing de- 


Printing of 




vice declared to be in 


DIRECTORY ceases 




error; error does not oc- 






cur without drastic cause 






(e.g., exhausting Pool of 






Empty Nodes) 




DTD-DETACH ERR 


DETACH Directive to the 
listing device or to the 
DECtape Hemdler declared 
to be in error; error does 
not occur unless operator 
reassigns listing LUN in 
midstream 


Command ignored 



VII-11-3 




CHAPTER 12 
NEW DECTAPE DIRECTORY: WRITING NEW DECTAPE DIRECTORY 



The NEW DECTAPE DIRECTORY TDV Function Task is used to write a new 
file directory on DECtape in standard format. 



12.1 INVOKING NEW DECTAPE DIRECTORY 

The user can invoke NEW DECTAPE DIRECTORY by typing a 
according to the following format: 



command 



Form: 


NEW[ DIRECTORY] V 


Example : 


TDV>NEW 

NEW DIRECTORY ON DECTAPE UNIT 4 

TDV> 



12.2 INPUT/OUTPUT AND TASK-BUILDING 

The NEW DIRECTORY TDV Function Task is assigned Task name NEW. . . at 
Task-Building time. This Task can be built to run in either USER 
(protected and relocated) or EXEC mode. It expects LUN-13 
(recommended dedicated terminal) to receive error and confirmation 
messages and LUN-19 for DECtape output. 



12.3 ERROR MESSAGES 

Table 12-1 lists possible error messages and their implications, 
messages are printed in the following format: 

TDV>NEW 

NEW-message 

TDV> 



All 
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Table 12-1 
NEW DIRECTORY Error Messages 



Error Message 


Meeining 


System Action 


NEW-ATTACH ERR 

NEW-NOT DECTAPE 
NEW-DECTAPE ERR 
NEW-DETACH ERR 


ATTACH Directive to the 
output device rejected; 
possible that DECtape 
I/O Hsundler not assigned 
to the output LUN 

Output LUN not assigned 
to the DECtape I/O 
Heuidler 

Attempt to write out one 
of the DECtape directory 
blocks failed 

DETACH Directive to the 
listing device rejected; 
error does not occur vin- 
less operator reassigns 
listing LUN in midstream 


Command ignored 

Commcind ignored 
No further action 
Command ignored 
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CHAPTER 13 
INSTALL: INSTALLING A TASK IN THE SYSTEM 



The INSTALL TDV Function task (also an MCR function task) adds a task 
to RSX previously built using the Task Builder. The Task Builder 
creates a binary file as output. When the INSTALL TDV Function task 
is invoked, the binary file is read from LUN-5 and recorded as an 
absolute image on the disk. The existence of the task is recorded in 
the System Task List. 

This function task has been implemented for batch processing, not for 
use under the MULTIACCESS Monitor. Its inclusion in the system (via 
atypical system build procedures) is permitted only to maintain 
compatibility with existing user batch streams. 



13.1 INVOKING INSTALL 

The user can invoke INSTALL by typing a command according 
format: 



to the 



Form: 



Where: 



Examples: 



INS [TALL] name [p]V 



name of task to be INSTALLed is a string of one 

to six .SIXBT characters 
p is an integer in the decimal range 1 to 512, 

specifying the task priority 



Priority has been set during task building: 

TDV> INSTALL SCAN 

TDV> 

Priority was not set at task building time or 

priority redefined here as 10: 
TDV>INS SCAN 10 
TDV> 



The user can override a priority specified during task building by 
indicating a priority in the INSTALL command line, if a priority has 
not previously been specified during task-building, an INSTALL 
priority is a required parameter. 



XVM/RSX VIB 
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13.2 INPUT/OUTPUT AND TASK-BUILDING 

The INSTALL Function Task is assigned task name INR ... at 
Task-Building tine. This task must be built to run EXEC mode. It 
expects LUN-13 (recorinvended dedicated terminal) to receive error 
messages and LUN-5 for binary file input. 



13.3 ERROR MESSAGES 

Table 13-1 lists possible error messages and their implications. All 
messages are printed in the following format: 

TDV>INS 

INS-message 

TDV> 
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Table 13-1 
INSTALL Error Messages 



Error Message 



INS-SYNTAX ERROR 



INS-TASK ALREADY IN 
SYSTEM 

INS-PARTITION NOT IN 
SYSTEM 



INS-TASK WOULD OVER- 
FLOW PARTITION 



INS-OUT OF POOL 

INS-OUT OF DISK 
INS-INPUT CHECKSUM ERR 

INS-INPUT PAR ERR 

INS-SYS COM BLK ERR 

INS-READ ERR ON LUN-5 
INS-DISK ERR 

INS-NO DEFAULT PRIORITY 



INS-FILE NOT FOUND ON 
LUN-5 

INS-RELOCATION HARD- 
WARE NOT AVA 

INS-FLOATING POINT 
HARDWARE NOT AVA 



Meeming 



Task name omitted or 
priority invalid 

Task to be INSTALLed has 
node in STL 

Partition name specified 
at Task- Building time not 
available 

Task to be INSTALLed too 
large for availeJale par- 
tition 

No nodes left in pool to 
create new STL entry 

No room left on the disk 

Error while performing 
checksum processing 

Error while performing 
parity checking 

INSTALL needs system coimnon 
block not currently in 
system 

Error in reading binary 
file from LUN-5 

Error while performing 
disk get or allocate oper- 
ation 

Priority not specified in 
INSTALL command, euid no 
priority included at Task- 
Building time 

Binary file not available 
for input from LUN-5 

No relocation hardware 
available on machine 

No floating-point hardware 
available on machine 



System Action 



Command ignored 
Commauid ignored 
Command ignored 

Command ignored 

Command ignored 

Command Ignored 
Commauid ignored 

Command ignored 

Command ignored 

Command ignored 
Comnand ignored 

Coimnand ignored 

Command ignored 
Command ignored 
Commcmd ignored 



VII-13-3 




CHAPTER 14 
REQUEST: REQUESTING TASK EXECUTION 



The REQUEST TDV Function task (also an MCR function task) REQUESTS the 
execution of a task at a specified software priority. Actual time of 
execution depends on task priority and partition availability. 

This function task has been implemented for batch processing, not for 
use under the MULTIACCESS Monitor. Its inclusion in the system (via 
atypical system build procedures) is permitted only to maintain 
compatibility with existing user batch streams. 

Tasks requested by this TDV function will not execute under control of 
the MULTIACCESS Monitor. 

14.1 INVOKING REQUEST 

The user can invoke REQUEST by typing a command according to the 
format: 



Form: 



Where: 



Examples; 



REQ[UEST] name [p]V 



name of task REQUESTed is a string of one to 

six .SIXBT characters 
p is an integer in the decimal range 1 to 51, 

specifying the task priority 



Priority has been set during task building or 

installation: 
TDV> REQUEST SCAN 
TDV> 

Priority is redefined here at 50: 

TDV>REQ SCAN 50 

TDV> 



The priority that has been specified during task building or 
installation can be overridden when the task is REQUESTed. If a new 
priority is not included in the command line, the task runs at the 
previously specified default priority. 



14.2 INPUT/OUTPUT AND TASK BUILDING 

The REQUEST TDV Function task is assigned task name REQ... at 
task-building time. This task can be built to run in either user mode 
(protected and relocated) or exec mode. It expects LUN-13 
(recommended dedicated terminal) to receive error messages. 



XVM/RSX VIE 
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14.3 ERROR MESSAGES 



Table 14-1 lists possible error messages and their implications, 
messages are printed in the following format: 



All 



TDV>REQ 

REQ-message 

TDV> 



Table 14-1 
REQUEST Error Messages 



Error Message 


Meaning 


System 


Action 


REQ-SYNTAX ERR 


Task name omitted or 
priority invalid 


Command 


ignored 


REQ-TASK NOT IN SYSTEM 


STL node for REQUESTed 
Task cannot be found 


Command 


ignored 


REQ-TASK ALREADY 
ACTIVE 


REQUESTed Task is 
currently active 


Commcuid 


ignored 


REQ-TASK DISABLED 


Task has been disabled 
eind is unavailable 


Command 


ignored 


REQ-POOL EMPTY 


No nodes left in pool to 
create new CKQ entry 


Command 


ignored 


REQ-PART LOST 


Partition in which Task is 
to run has been lost 
because of reconfiguration 


Command 


ignored 
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CHAPTER 15 
REMOVE: REMOVING A TASK FROM THE SYSTEM 



The REMOVE TDV Function task (also an MCR function task) deletes an 

inactive task from the system. If the user plans to alter and 
reinstall a task, he must REMOVE it first. 

This function task has been implemented for batch processing, not for 

use under the MULTIACCESS Monitor. Monitor. Its inclusion in the 

system (via atypical system build procedures) is permitted only to 
maintain compatibility with existing user batch streams. 



15.1 INVOKING REMOVE 

The user can invoke REMOVE by typing a command according to the 
format: 



Form: 


REM[OVE] nameV 


Where: 


name of task to be REMOVEd is a string of one 
to six .SIXBT characters 


Example: 


TDV> REMOVE SCAN 
TDV> 



15.2 INPUT/OUTPUT AND TASK BUILDING 

The REMOVE TDV Function task is assigned task name REM... at 
task-building time. This task must be built to run in exec mode. It 
expects LUN-13 (recommended dedicated terminal) to receive error 
messages. 



15.3 ERROR MESSAGES 

Table 15-1 lists possible error messages and their implications, 
messages are printed in the format: 

TDV>REM 

REM-message 

TDV> 



All 
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Table 15-1 
REMOVE Error Messages 



Error Message 



REM-TASK ACTIVE 

REM- SYNTAX ERR 
REM-TASK NOT IN SYSTEM 

REM-DISK ERR 

REM-ALLOCATE ERROR 



REM-TASK HAS 
MULTIPLE STL 
ENTRIES 



Meaning 



Task to be REMOVEd is 
currently active 

Task name omitted 

STL node for task to be 
REMOVEd cannot be found 

Error while performing 
disk GET operation 

Error while performing 
disk ALLOCATE operation 

Disk space allocated to 
this task cannot be 
deallocated at this time 



System Action 



Command ignored 

Command ignored 
Command ignored 

Command ignored 

Command ignored 

Command ignored 
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CHAPTER 16 
MOUNT: LOGICALLY MOUNTING A DISK 



The MNT TDV Functions task (also an MCR function task) specifies UFDs 
for all LUNs assigned to the named disk where no UFD specification has 
previously been made. For additional information, refer to the 
documentation on the MNT MCR Function task in Part IV of this manual. 

This function task is not recommended for use under the MULTIACCESS 
Monitor. Its inclusion in the system (via atypical system build 
procedures) is permitted only to maintain compatability with existing 
user batch streams. 



16.1 INVOKING MOUNT 

The user can invoke MOUNT by typing a command according to the format; 



Form: 



Where; 



Example: 



MNT Rnm UFDV 



Rn is disk type: RF, RP or RK 
m is a valid disk unit number 
UFD is a valid three-character user file 
directory 



TDV>MNT RP3 ABN 
TDV> 



16.2 INPUT/OUTPUT AND TASK BUILDING 

The MOUNT TDV Function task is assigned task name MNT... at 
task-building time. This task must be built to run in exec mode. It 
expects LUN-13 (recommended dedicated terminal) to receive error 
messages. 



16.3 ERROR MESSAGES 

Table 16-1 lists possible error messages and their implications, 
messages are printed in the format: 

TDV>MNT 

MNT-message 

TDV> 



All 
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Table 16-1 
MOUNT Error Messages 



Error Message 


Meauiing 


System Action 


MNT-ALLOCATION ERROR 

MNT-DISK PUT ERROR 

MNT-FORMAT ERROR 

MNT-DISK HAS NO PDVL 
NODE 

MNT-DEVICE IS NOT A 
DISK 

MNT-ILLEGAL TO MOUNT 
THE SYSTEM DISK 

MNT-DISK NOT DIS- 
MOUNTED 

MNT-DISK GET ERROR 


Error while performing 
disk ALLOCATE operation 

Error while performing 
disk PUT operation 

Invalid device name, unit, 
or UIC 

PDVL node for specified 
disk cannot be found 

Device name does not cor- 
respond to a disk in the 
RSX system 

Device name corresponds to 
the system disk 

Specified disk has not 
been dismounted since last 
mount 

Error while performing 
disk GET operation 


Command ignored 
Command ignored 
Command ignored 
Command ignored 
Command ignored 

Command ignored 
Command ignored 

Commeind ignored 
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CHAPTER 17 
DISMOUNT: LOGICALLY DISMOUNTING A DISK 



The DSM TDV Function task (also an MCR function task) dismounts a user 
disk and, therefore, disables all file-oriented I/O addressed to the 
disk. For additional information, refer to the documentation on the 
DSM MCR Function task in Part IV of this manual. 



This function task is not recommended for use under the MULTIACCESS 
Monitor. Its inclusion in the system (via atypical system build 
procedures) is permitted only to maintain compatability with existing 
user batch streams. 



17.1 INVOKING DISMOUNT 

The user can invoke DISMOUNT by typing a command according to the 
format: 



Form: 



Where; 



Example: 



DSM RnmV 



Rn is disk type: RF, RP or RK 
m is a valid disk unit number 



TDV>DSM RK6 

DISK IS READY FOR DISMOUNTING 

TDV> 



17.2 INPUT/OUTPUT AND TASK BUILDING 

The DISMOUNT TDV Function task is assigned task name DSM... at 
task-building time. This task can be built to run in exec mode. It 
expects LUN-13 (recommended dedicated terminal) to receive error 
messages. 



17.3 ERROR MESSAGES 

Table 17-1 lists possible error messages and their implications, 
messages are printed in the format: 



All 



TDV>DSM 

DSM-message 

TDV> 
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Table 17-1 
DISMOUNT Error Messages 



Error Message 


Meaning 


System Action 


DSM-FORMAT ERROR 

DSM-DISK HAS NO PDVL 
NODE 

DSM-DEVICE IS NOT A 
DISK 

DSM-ILLEGAL TO DIS- 
MOUNT THE SYSTEM 
DEVICE 

DSM-DEVICE NOT MOUNTED 

DSM-DEVICE IS IN USE 

DSM-MA.RK TIT1E ERROR 


Invalid device name or 
unit 

PDVL node for specified 
disk cannot be found 

Device name does not cor- 
respond to a disk in the 
RSX system 

Device name corresponds to 
the system disk 

Disk to be dismounted is 
not currently mounted 

Specified disk is current- 
ly being used for I/O 

Error encountered while 
marking time until all 
open files are closed 


Commeind ignored 
Command ignored 
Command ignored 

Command ignored 

Command ignored 

Command ignored 
Command ignored 
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CHAPTER 19 
CONSTRUCT: STORING A TASK ON A USER DISK 



The CONSTRUCT TDV Function task (also an 
task to RSX previously built by the Tas 
invoked, the binary file is read from 
function, however, the task core image i 
a disk, not simply in allocated space on 
space on the user disk is allocated by 
that specifies the disk on which the crea 
usually be included in the CONSTRUCT 
CONSTRUCT does not affect the System Task 



MCR function task) adds a 

k Builder. When CONSTRUCT is 

LUN-5. Unlike the INSTALL 

s stored in a created file on 

the system disk. Because 

the disk file handler, a LUN 

ted file is to reside must 

command. Unlike INSTALL, 

List in any way. 



19.1 INVOKING CONSTRUCT 

The user can invoke CONSTRUCT by typing a command according to the 
format: 



Form: 



Where: 



Example: 



CON I STRUCT] name [LUN]V 



name of task to be CONSTRUCTed is a 
string of one to six .SIXBT characters 

LUN is an integer representing a logical 
unit number currently associated with 
a disk (the default value is decimal 
14) 



TDV>CON SCAN 16 
TDV> 



19.2 INPUT/OUTPUT AND TASK BUILDING 

The CONSTRUCT TDV Function task is assigned task name CON... at 
task-building time. This task can be built to run in either user mode 
(protected and relocated) or exec mode. It expects LUN-13 
(recommended dedicated terminal) to receive error messages and LUN-5 
to be assigned for binary file input. 



XVM/RSX VIB 



VII-19-1 



September 1976 



19.3 ERROR MESSAGES 



Table 19-1 lists possible error messages and their implications, 
messages are printed in the format: 



All 



TDV>CON 

CON-message 

TDV> 



Table 19-1 
CONSTRUCT Error Messages 



Error Message 


Meaning 


System 


Action 


CON- SYNTAX ERROR 


Task name or LUN omitted 
or invalid or out-of-range 
LUN 


Command 


ignored 


CON-CREATE ERR 


Error while performing 
create operation 


Command 


ignored 


CON-READ ERR 


Error while performing 
READ operation 


Command 


ignored 


CON-DISK ERR 


Error while performing 
disk GET or ALLOCATE 
operation 


Command 


ignored 


CON-FILE NOT FOUND 


Binary file not available 
on LUN- 5 


Command 


ignored 
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CHAPTER 21 
QUEUE: QUEUING A BATCH JOB 



The QUEUE TDV Function task (also an MCR function task) informs the 
batch processor that a job is ready to be run, whether or not the 
batch handler is in core. The user can specify the name of the job to 
be queued, the LUN from which it comes and a series of job 
characteristics, including: 

• Maximum time that the job can run (in minutes) 

• Class at which the job can run 

• Memory use 

• Use of sequencing (run in order of submission) 

• Whether the job requires operator availability 

• Whether QUEUE expects to find the job on the specified device 
at this time 

• Whether the job file should be deleted after the job runs 

• use of hold mode 

• whether the job is to be forced 

21.1 INVOKING QUEUE 

Job characteristics can be delimited in the command string by one or 
more spaces, commas or both. The following examples show various 
forms of delimited parameters. The user can invoke QUEUE by typing a 
command according to the format: 
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I 



Form: 


QUE[aE] [name] [LUN] [T=time] [C=class] 
[M=memory] [SEQ] [OPR] [NCK] [DEL] 
[HLD] [STK] [FRC]V 


Where: 


name of task to be queued is a string of one 

to six characters (first character must be 

alphabetic). E<^ ^<J'i< SE ":ro6' 
LUN is an integer representing a logical unit 

number currently in the system 
time is an integer in the decimal range 1 to 

1023, representing the maximum number of 

minutes that the job can run 
class is an integer in the decimal range to 

7 
memory is an integer in the decimal range 1 

to 128, representing memory use (in K) 


Examples: 


TDV>QUE COMPIL 

TDV>QUE NAMX 15 SEQ C=2 

TDV>QUE SCAN 5 T=C C=3 M=28 SEQ SPN 

■rDV>QUE 14 NCK 



All parameters of the QUEUE command are optional. In practice, 
however, a name or LUN is often specified for one of the following 
reasons: 

1. The default LUN is LUN-17; usually assigned to the disk. 
Specification of an explicit LUN is necessary to override 
this default. 

2. The name can be omitted if the LUN from which it comes is not 
associated with a file-oriented device. In the example: 



TDV>QUE 14 

14 is associated with the card reader 
requires no explicit name definition. 



and the command 



3. If the first character of a QUEUE command line is numeric, it 
is assumed that the name has been omitted and the number 
represents the LUN of a non-file-oriented device. The user 
should ensure that names included in the command line begin 
with an alphabetic character. 

The HLD option causes QUEUE to queue the job, but to leave it in the 
hold mode until the operator releases it. The STK option causes QUEUE 
to stack the job by copying it into a temporary file on disk and 
queuing it. STK implies deletion after execution. 

If the file is on DECtape or disk and if NCK and STK have not been 
specified, QUEUE opens the file, reads the JOB record and outputs 
errors, if necessary. If a memory size is specified and not enough 
core is available to run, the job waits until the TDV partition is 
• large enough. 
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Job information defaults are: 
Parameter Default 

T Time specified in the job file 

C Zero 

M Core available at the time the job is run (0) 

SEQ No use of sequencing 

OPR Job does not require operator availability 

NCK Job is on the specified device at this time 

DEL Preserve the job file after the run 

HLD Run the job as soon as priority permits 

STK Do not copy the job file to the disk 

FRC DO not force 

21.2 INPUT/OUTPUT AND TASK BUILDING 

The QUEUE Function task is assigned task name QUE... at task building 
time. This task can be built to run in either user mode (protected 
and relocated) or exec mode. It uses LUN-13 to receive error 
messages. 

21.3 ERROR MESSAGES 

Table 21-1 lists possible error messages and their implications. All 
messages are printed in the format: 

TDV>QUE 
message 
TDV> 
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Table 21-1 
QUEUE Error Messages 



Error Message 


Meaning 


System Action 


FORMAT ERROR IN COMMAND 


One or more 
nonexistent options 
in command line 


Command ignored 


ILLEGAL VALUE FOR ARGUMENT 


Illegal T,C,M, or U 
eurgument 


Command ignored 


CANNOT INPUT FROM 
DEVICE SPECIFIED 


Nothing to input 
from that LUN 


Command ignored 


NEED FILE NAME FOR 
THIS DEVICE 


File-oriented LUN 


Commemd ignored 


FILE NOT FOUND 


File cannot be found 


Command ignored 


READ ERROR 


Error during READ 
operation 


Command ignored 


JOB RECORD MUST BE 
FIRST LINE 


First line not JOB 
record 


Command ignored 


INCORRECT JOB LINE 
FOLLOWS 


Incorrect time limit 
specification; not 
three digits or not 
in correct sequence 


Command ignored 


IMPOSSIBLE TO 
QUEUE JOB 


Exec or empty 
nodes unavailable 


Command ignored 


TDV COMMAND 
TRANSFER ERROR 


Error in TDV 
Command transfer 


Command ignored 
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CHAPTER 22 
ODT: OCTAL DEBUGGING TECHNIQUE 



The ODT TDV Function task allows users to debug tasks with an "octal 
debugging technique" under XVM/RSX. It permits users to start and 
stop tasks, examine and modify task registers and locations within the 
task partition, set and remove breakpoints within the task, and 
proceed with task execution after a breakpoint has been reached. ODT | 
allows the user to define symbols for program addresses so that 
command parameter inputs can be given as either octal numbers or 
previously defined symbols. Furthermore, ODT monitors task progress | 
to ensure that the task does not permanently prevent other system 
activities if it enters an infinite loop. 

Because of the way that breakpoints are handled, the following 
restrictions apply to tasks debugged using ODT: 

1. Tasks must be built in user mode. If the user attempts to 
debug an exec-mode task with ODT, the error message "EXEC I 
MODE" is printed and ODT is reinitialized. | 

2. Tasks can have no overlays. If the user debugs a task with 
overlays using ODT, he should use extreme caution so that no | 
breakpoints are set within a link. 

3. Tasks cannot modify virtual address 17 (autoincrement 
register X17) . 

4. Tasks cannot modify virtual addresses to 3. 

5. Tasks cannot modify the instruction at a breakpoint. 

The last four restrictions are not checked by ODT. If the user task | 
violates these restrictions, system integrity is not compromised, but 
the user task will probably fail to run correctly. 
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22.1 INVOKING ODT 

The user can invoke ODT by typing a command according to the format: 



Form: 


ODT name [LUN]V 


Where: 


name of a CONSTRUCTed task 
image is a string of 
one to six .SIXBT characters 

LUN is an integer representing the 
logical unit number on which 
the file resides (the default 
value is decimal 14) 


Example: 


TDV>ODT SCAN 16 
TDV> 



22.2 DEBUGGING WITH ODT 

When ODT begins execution, it prints a header message and attempts to 
fix the specified task in core. If the task can be fixed, ODT 
requests additional commands by typing the prompter: 

ODT> 

If the task cannot be fixed in its partition for any reason, ODT 
prints the message "FIX ERR" and exits. 

In response to the ODT prompter, the user can enter any one of the 
following commands: 



Command 

OPEN 

START 

EXIT 

DEFINE 

SET 

REMOVE 

CONTINUE 

RESTART 
RELOAD 

DUMP* 

DECODE* 

REGISTERS* 



Function 

Opens a register or memory location 

Starts the task 

Exits and aborts the task 

Defines a symbol 

Sets a breakpoint 

Removes a breakpoint 

Continues task execution after 

reaching a breakpoint 

Restarts the task at some location 

Reloads the task with symbols and 

breakpoints 

Dumps the task partition into a 

created file on disk 

Decodes the opened memory locations 

or stops decoding the opened memory 

locations 

Prints all registers when the task 

has reached a breakpoint 



Each of these 
paragraphs. 



commands is described in detail in the following 



* Legal only if ONEPLS was defined 
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22,2.1 OPEN 

The OPEN command examines and optionally modifies the contents of task 
registers or locations within the task partition. The format of this 
command is : 

ODT>0PE[N] nnnnnn 

where nnnnnn is an address relative to the base of the task partition. 
The nnnnnn specification can be a symbol or one of the following 
registers: $AC, $MQ, $XR, $LR, $LINK or $XlO TO $X16. 

ODT prints the contents of the location or register and waits for a 
response. If a value (octal only) is then given as a response, that 
value replaces the former contents. If only a terminator is typed, 
ODT does not modify the current contents of the register or location. 
If the response is terminated with an altmode, a new command is 
requested. If the response is terminated with a carriage return, the 
next location is opened (unless a register was specified) . If a 
register was specified, a new command is always requested. 

If a new value for the link is to be entered, only bit 17 of the octal 
word typed is relevant. 

This command is legal any time, but registers can be opened only if 
the task is at a breakpoint. 



22.2.2 START 

The START command begins execution of the task being debugged. The 
format of this command is: 

ODT>STA[RT] 

This command can be used only if the task has not already been 
started. 



22.2.3 EXIT I 

The EXIT command terminates the debugging session for a particular 
task. The format of this command is: 

ODT>EXI[T] 

The EXIT command causes the task to abort. This command is legal any 
time . 
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I 22.2.4 DEFINE 

The DEFINE command defines a symbol. Once a symbol has been defined, 
it can replace program addresses indicated in octal notation in other 
coininand string inputs. The format of this command is: 



ODT>DEF[INE] 



xxx=nnnnnn 



where xxx is a one- to three-character symbol and nnnnnn is any octal 
number. After the first three characters of a symbol are input, 
subsequent characters are ignored. Unlike other commands, nnnnnn for 
this command cannot be a symbol. 

This command is legal any time. 



I 22.2.5 SET 

The SET command enters a breakpoint into the task at some location 
specified. When the executing task reaches a breakpoint, its progress 
is stopped prior to the execution of the instruction at which the 
breakpoint is SET. The format of this command is: 

ODT>SET nnnnnn 

• where nnnnnn is an address relative to the base of the task partition, 
and can be a symbol . 

This command is legal any time. 



22.2.6 REMOVE 

The REMOVE command removes a breakpoint from the task. It complements 
the SET command. The format of this command is: 

ODT>REM[OVE] nnnnnn 

where nnnnnn is an address relative to the base of the task partition, 
and can be a symbol. 

This command is legal any time. 
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22.2.7 RESTART | 

The RESTART command causes the task to be started at the location 
specified once that task has reached a breakpoint. The format of this 
command is: 

ODT>RES[TART] nnnnnn 

where nnnnnn is an address relative to the base of the task partition, • 
and can be a symbol. 

This command is legal only if the task is at a breakpoint. 



22.2.8 RELOAD 

The RELOAD command instructs ODT to reload the task image (i.e., 
refresh the task partition with a new copy of the task). Breakpoints 
and symbols defined when this command is issued are retained, but the 
contents of user-modified locations are lost. The format of this 
command is: 

ODT>REL[OAD] 

This command is legal any time. 



22.2.9 CONTINUE 

The CONTINUE command is used to resume task execution once a 
breakpoint has been reached. The format of this command is: 

ODT>CON[TINUE] 

This command is legal only if the task is at a breakpoint. 



22.2.10 REGISTERS 

The REGISTERS command is legal only if the assembly parameter ONEPLS 
was defined. The format of this command is: 

ODT>REG[ISTERS] 

This command prints the contents of the AC, MQ, XR, LR and link. 

This command is legal only if the task is at a breakpoint. 



22.2.11 DECODE 

The DECODE command sets a flag to tell the OPEN command whether it 
should print the opcodes of opened locations as well as their 
contents. The format of this command is: 

ODT>DEC[ODE] String 
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Where string is either "ON" or "OFF" 

If string is '•ON", tfte opcodes are decoded. If string is "OFF", the 
opcodes are not decoded. (No opcode decoding is the default .mode of 
operation for the OPEN command.) The DECODE command is valid only if 
ONEPLS was defined when ODT was assembled. 

This command is legal any time. 



22.2.12 DUMP 

The DUMP command is used to write an image of tae task partition into 
an RSX-created file on disk. The file is named TSKNAM DMP, where 
TSKNAM is the task name. The image of the task does not contain 
breakpoints, but all breakpoints are restored when the dumping process 
is complete. This command is valid only if ONEPLS was defined when 
ODT was assembled. The format of this command is: 

ODT>DUM[P] 

This command is legal any time. 



22.3 MONITORING TASK PROGRESS 

vvhenever a task has been started, restarted or continued after a 
breakpoint, ODT monitors its progress. If the task does not exit or 
reach a breakpoint within several seconds, ODT prints the task ATL 
status and asks the user whether the task should be aborted. If the 
user types "NO", ODT resumes monitoring task progress. If the user 
types "YES", ODT reloads the task, aborting it in the process. If the 
task exits while ODT is monitoring its progress, the message "TASK HAS 
EXITED" is printed. The task is then reloaded. 



I 22.4 AN EXAMPLE OF ODT USE 

The following listing gives an example of a task to be debugged with 

I ODT. This program contains two errors that will be found and 
subsequently corrected using ODT. The program consists of a main 
section and a single subroutine. The function of the main section is 
to simulate input data and call the subroutine. The subroutine, which 
is presumably used in another program, is intended to count the bits 
that are set in the accumulator on entry to the subroutine. It is 
this subroutine that contains errors and can be debugged using ODT. 

When the example program is task built, it is relocated so that 
location in the listing corresponds to the base address of the 
partition for this task plus 20 (octal) . 

The example program is listed on the following page: 
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/ 



< 

H 
H 
I 

to 

lO 

I 



en 
(+ 



(D 






3 
4 
5 
6 

7 
8 
9 

10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 

23 
24 
25 
26 
27 
2(3 
29 
30 
31 
32 
33 
34 
35 
36 

37 
38 
39 
40 
41 
42 

43 
44 
45 



3T THE SUBROUTINE 'ONECNT' 
AC ON ENTRY TO THE 



/ THIS PROGRAM IS INTENDED TO TE 

/ WHICH COUNTS THE 1 BITS IN THE 

/ SUBROUTINE. 

/ 

/ AS GIUEN HERE* THIS SUBROUTINE HAS TWO ERRORS 

/ 







440000 


A 


IDX=^ 


= ISZ 










000010 


A 


XI 0= 

/ 

STAFi 


= 10 






00000 


R 


2000S3 


R 


!T 


LAC 


(BUFF--1 


00001 


R 


060054 


R 






DAC* 


(XIO 


00002 


R 


200055 


R 






LAC 


(654321 


00003 


R 


100013 


R 






JMS 


ONECNT 


00004 


R 


200056 


R 






LAC 


(123456 


00005 


R 


100013 


R 






JMS 


ONECNT 


00006 


R 


777777 


A 






LAW 


-1 


00007 


R 


100013 


R 






JMS 


ONECNT 


00010 


R 


750000 


A 






CLA 




00011 


R 


100013 


R 






JMS 


ONECNT 


00012 


R 


000054 


R 






CAL 


(10 



/USED IF INTENT IS TO INCREMENT ONLY 
/AUTOINCREMENT REGISTER 10 

/INITIALIZE XIO 

/USE XIO AS A BUFFER POINTER FOR 

/STORING RESULTS. 

/GET 1ST DATA WORD 

/GO COUNT THE ONE'S 

/GET 2ND DATA WORD 

/GO COUNT THE ONE'S 

/GET 3RD DATA WORD 

/6Q COUNT THE ONE'S 

/GET 4TH DATA WORD 

/GO COUNT THE ONE'S 

/EXIT 



/ 

/ SUBROUTINE ONECNT ■■— COUNT THE 

/ STORE RESULTS UIA XIO 

/ 



00013 


R 


000000 


A 




ONECNT 







00014 


R 


652000 


A 






LMQ 




00015 


R 


777756 


A 






LAW 


■•■•22 


00016 


R 


040051 


R 






DAC 


BITCNT 


00017 


R 


744000 


A 






CLL 




00020 


R 


641002 


A 






lac; (3 




00021 


R 


740010 


A 




LOOF' 


RAL 




00022 


R 


740400 


A 






SNL 




00023 


R 


440052 


R 






IDX 


ONES 


00024 


R 


440051 


R 






ISZ 


BITCNT 


00025 


R 


600021 


R 






JMP 


LOOP 


00026 


R 


200052 


R 






LAC 


ONES 


00027 


R 


060010 


A 






DAC* 


XIO 


00030 


R 


620013 


R 




/ 
BUFF 


JMP* 


ONECNT 


00031 


R 




A 




.BLOCK 


20 


00051 


R 


000000 


A 




BITCNT 







00052 


R 


000000 
000000 


A 
A 




ONES 




.END 




00053 


R 


000030 


R 


*L 








00054 


R 


000010 


A 


tL 








00055 


R 


654321 


A 


*L 








00056 


R 


123456 


A 


*L 








s; 


[ZE 


:=00057 






NO ERROR 


LINES 





ONE BITS IN THE AC ON ENTRY c 



/SAUE THE DATA WORD IN MQ 
/SET UP A BIT COUNTER 

/CLEAR THE LINK 

/RETRIEVE DATA WORD 

/SHIFT BITS AND TABULATE ONE'' 



/DONE WITH WORD? 

/NO CONTINUE 

/YES STORE RESULT 

/RETURN 

/RESULTS BUFFER 
/BIT COUNTER 
/ONE'S COUNTER 



The following terminal output shows how ODT can be used to debug the 
subroutine in the example program: 



TI.iy>ODT TEST 

ODT VIBOOO 
ODT>riEF BUF==31 

ODT>riEF B:[T==51 
ODT>DEF 0NE~52 
ODT>SET 24 

OriT>SET 26 
OIiT>SET 30 
ODT>SET 32 

ODT>START 
BRKPT AT 000024 

OIiT>OPEN BUF 

000051 : 000011 : 

000052 } 101550 J 

000053 : 600411 J 

ODT>OPEN ONE 
000072 : 000011 I 
OriT>0PEN BIT 

000071 : 000000 j 

ODT>CONT 

BRKPT AT 000026 

OriT>OPEN BUF 

000051 ;ooooii : 

000052 : 000022 { 

000053 1600411 5 
ODT>OPEN ONE 

000072 J 000022 : 

ODT>RELOAD 

OriT>OPEN 37 

000037 J744000 : 140072 

OriT>START 

BRKPT AT 000024 

ODT>OPEN BUF 

000051 lOOOOll : 

000052 : 101550 J 

000053 : 600411 J 

ODT>OPEN ONE 
000072 JOOOOll : 
ODT>CONT 

BRKPT AT 000026 
ODT>OPEN BUF 

000051 :ooooii : 

000052 : 000011 i 

000053 1600411 : 
ODT>0PEN ONE 

000072 : 000011 I 

ODT>C0NT 

BRKPT AT 000030 



-•-Name program to be debugged. 



Define symbols for later use 
in command inputs. 



Set breakpoints at all 
subroutine return addresses. 



*-=?tart execution of the task. 
-•—A breakpoint has been reached 
location 4 (LI) . 



at 



[ Open those locations that show 
[ the results of the subroutine. 
' The first result is correct. 

Open subroutine temporary 
variables to check them. They 
' are OK so far. 
•-Continue task execution. 
«-A breakpoint has been reached at 
location 6 {L2) • 

Check the results buffer and 
subroutine temporary storage 
locations. An error has been 
found. The temporary storage 
location ONES must be zeroed 
before counting. 
♦-Reload the task into memory 
keeping symbols and breakpoints. 
-^Change location 17 from a CLL to 
a DZM ONES. 

■•-Start task execution. 
*-The first breakpoint has been 
reached. 



Check results. They look OK. 



"•-Continue task execution. 
••-The next breakpoint has been 
reached. 



Check results again. OK. 



••-Continue. 

■•-Another breakpoint has been 
reached. 
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OriT>OPEN BUF 

000051 } 000011 J 

000052 JOOOOll : 

000053 J 000000 J 
ODT>RELOAD 
ODT>OPEN 42 

000042 J740400 :741400 

OriT>OPEN 37 

000037 :744000 U40072 

ODT>START 
BRKPT AT 000024 
ODT>OPEN BUF 

000051 tOOOOll : 

000052 {101550 t 

000053 1600411 { 

ODT>CONT 

BRKPT AT 000026 

ODT>OPEN BUF 

000051 JOOOOll ; 

000052 tOOOOll J 

000053 :600411 : 
ODT>CONT 

BRKPT AT 000030 
ODT>OPEN BUF 

000051 :ooooii : 

000052 lOOOOll I 

000053 ;000022 J 

000054 J 101635 5 



000055 ;: 

ODT>CONT 

BRKPT AT 

ODT>OPEN 

000051 

000052 

000053 

000054 

000055 

ODT>OPEN 

777770 

ODT>EXIT 
TDy> 



>04217 ! 

000032 

BUF 
000011 ! 
000011 ! 
000022 ! 

000000 ; 

204217 ! 

*X10 
000054 ! 



1 Check results again. Another 
error has been found. The 
subroutine is counting cleared 
bits instead of set bits. 
♦-Reload the task once again. 
\ Change location 22 from an SNL 

; to an SZL instruction. 
-^Enter previous correction. 

•^Start task execution and check 
the results at each breakpoint as 
they are reached. Use the same 
procedures as above. 



♦-The final breakpoint has been 
reached and the subroutine 
output looks fine. 



♦-Examine autoincrement register 
10 to be sure that it points to 
the correct location within the 
data buffer. It does, so leave 
DDT. 



22.5 ERROR MESSAGES 

Table 22-1 lists possible error messages and their implications. 
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Table 22-1 
ODT Error Messages 



Message 



HINF ERR 
PUT ERR 

CREATE ERR 

ILLEGAL 

BRDPT AT XCT 

EXEC MODE* 
READ ERR* 

FORMAT ERR 



FIX ERR* 

TASK NOT IN STL* 

WHAT? 

ALREADY STARTED 

REQUEST ERR* 



Meaning 



HINF error on LUN-14 

ODT is unable to write 
the task image to disk 

GOT is unable to 
CREATE a file on 
LUN-14 

Registers cannot be 
opened unless the task 
is at a breakpoint 

Illegal to have a 
breakpoint at XCT 
instruction 

Task is in exec mode 

Terminal read error 



Violation of command 
syntax 



ODT is unable to FIX 
the task 

Task specified is not 
in the system** 

Unrecognized command 

Task was previously 
started 

ODT is unable to 
REQUEST the task 



Routines Generating 
Error Message 



DUMP 
DUMP 

DUMP 
OPEN 
SET, OPEN 



ODT INITIAL r/,AriON 

ODT INITIALIZATION, 
COMMAND DISPATCH, 
OPEN, MONITOR 
ROUTINE 

ODT INITIALIZATION, 
COMMAND DISPATCH, 
RESTART, SET, 
REMOVE, OPEN, 
DECODE 

ODT INITIALIZATION, 



ODT INITIALIZATION 

COMMAND DISPATCH 
START 

START 



(Continued) 



♦Causes ODT to exit. 



**This error should never appear unless the system list structure has 
been corrupted. 
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Table 22-1 (Cont. ) 
ODT Error Messages 



Message 


Meaning 


Routines Generating 
Error Message 


TABLE FULL 


Breakpoint or symbol 
table full 


DEFINE, SET 


ALREADY DEFItJeO 


"ireakpoint has already 
been defined or set 


SET 


NOT AT A BRKPT 


Task is not at a 
breakpoint 


RESTART, CONTINUE, 
REGISTERS 


NOT IN TABLE 


Breakpoint is not in 
the table 


CONTINUE, REMOVE 


ATTACH ERR* 


ODT is unable to 
ATTACH the terminal 


ODT INITIALIZATION, 
COMMAND DISPATCH, 
MONITOR 


TASK NOT IN ATL* 


Task is deleted from 
ATL 


ODT INITIALIZATION, 
CONTINUE 


OUT OP BOUNDS 


Address is not within 
the task partition 
space 


RESTART, SET, 
REMOVE, OPEN 



♦Causes ODT to exit. 



XVM/RSX VIE 



VII-22-11 



September 1976 I 




CHAPTER 23 
STATUS: MULTIACCESS STATUS REPORT 



The STATUS TDV Function task prints a status report of internal 
MULTIACCess information. This status information is intended for use 
by the system manager and, in general, is not of interest to the TDV 
user . 



23.1 INVOKING STATUS 

The user can invoke STATUS by typing a command according to the 
format: 



Form: 


STA[TUS]V 


Example: 


TDV>STA 
TDV> 



23.2 INPUT/OUTPUT AND TASK BUILDING 

The STATUS TDV Function task is assigned task name STA. . , at 
task-building time. This task is written in FORTRAN and should be 
built to run in user mode (protected and relocated) . Output status 
information is sent to LUN-16. 

A sample STATUS report is listed below: 
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TnV>STA 

MULTIACCESS STAT 
1 ACTIVE USH^RCS 
TOTAL NUHBER OF" 

TOTAL NUMBER OF 
MEAN WAIT TIME 
ACTIVE TERMINAL 
THERE ARE 198 

T 
000000-001777 

006000-007777 
014000-015777 
022000-023777 
030000-031777 
036000-037777 
044000-045777 

052000-053777 
060000-061777 
066000-067777 

074000-075777 
Ti:iV> 



US REPORT 13-JUL-76 OS 13 HOURS 
) 
USER(S) :== 1 

JOB(S) - 
IS 0*00 SE 
NUMBERS Af; 

(10) WORDS OF BYNAMIC STORAGE 

ASK SIZE h:i 



002000 
010000 
016000 
024000 
032000 
040000 
046000 

054000 
062000- 
070000 

076000 



15 
CONDS/JOB 
E i 

OF iCiYNAMIC 
STOGRAM 
■003777 

-011777 
-017777 
-025777 
-033777 
-041777 
-047777 

-055777 
-063777 
-071777 

-077777 



00 4 000- OC 
012000-01 
020000-02 
026000-02 
034000-03: 
042000-04: 
050000-05 

056000-OS 
064000-06 
072000-07 
100000-77 



5777 
3777 
1777 
7777 
5777 
3777 
1777 

7777 

5777 
3777 

7777 



4 















The status report presents important current information and 
historical information compiled since TDV started running. Current 
information includes: 

• Number of active users 

• Active terminal numbers 

• Words of dynamic storage (this system management concept is 
fully documented in the TDV code listing) 

Historical information includes: 

• Total number of different users 

• Total number of jobs handled 

• Mean wait time per job 

• Number of tasks that have been run in each of 33 size ranges, 
each progressively increasing by 2000 (octal) words 
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CHAPTER 24 
BATCH ACCOUNT FILE INITIALIZATION AND DISPLAY 



Two TDV function tasks, ACI and ACD, control batch job accounting and 
account summaries. The use of ACI and ACD is described in Part VIII 
of this manual. Batch Processing. 



24.1 ACI: INITIALIZE BATCH ACCOUNT FILE 

ACI allows the system manager to initialize (clear to zero) the Batch 
processor account file or create an account file if one does not exist. 



24.2 ACD: DISPLAY BATCH ACCOUNT FILE 

ACD allows the system manager to list the Batch Processor account file. 
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INDEX 



Abbreviations for commands, 1-9 
ACD, TDV Function task, 24-1 
ACI, TDV Function task, 24-1 
Altmode, 1-8, 6-3, 6-9 
Assembler options, 3-2 
Assembling a MACRO program, 3-1 
"At" sign (@) , 1-9 
Auxiliary disk functions, 2-3 



Backarrow {-<-) , 1-9, 7-3 
Backslash (\) , 1-9 
Bank-mode option, 6-7 
Basic Task Builder, 6-1, 6-18 
Batch account file, 

display, 24-2 

initialization, 24-2 
Batch file editing, 5-1 
Batch mode, 3-1 

FORTRAN, 2-1 

MACRO Assembler , 3-1 

processing, 13-1, 14-1, 15-1 
Block-mode editing, 4-1 
Braces {\ \) , 1-10 
Breakpoints in a task, 22-1 
Buffer and partition size, 4-3 
Building a task for execution, 
6-1 



Date, 11-1 

Debugging with ODT, 22-2 

DECtape Directory List TDV, 

Function task, 11-1 

error messages, 11-2, 11-3 
Default priority of task, 6-8 
Delete character or line, 1-9 
DELETE FILE error messages, 8-2 
DELETE FILE, TDV Function 

task, 8-1 
Delimiters, 7-3 
Devices, I/O, 1-6 
Dialogue, TKB, 6-17 
DIRECTORY LIST, TDV Function 
task, 10-1 

error messages, 10-2, 10-3 
Disk directory, 10-1 
Disk, task storage on, 19-1 
Disk-to-disk editing, 4-3 
DISMOUNT, TDV Function task, 17-1 

error messages, 17-1 
Dismounting a disk (logically) , 

17-1 
Dismount tape, 7-4 
-$ command, 5-5 
DSM, TDV Function task, 17-1 
Dump mode, 3-6 



Carriage return, 1-8 

CHAIN and EXECUTE programs, 6-4 

Characters, upper/lower case, 

1-10 
Comma character, 7-2 
Command abbreviations, 1-9 
Command string terminators, 1-8 
Command syntax errors, SLIP, 

5-16 
Commands, MULTIACCESS Monitor, 

1-2.1 
COMMON blocks, 6-8, 6-10, 6-11 
Compiler options, FORTRAN IV, 

2-2 
Compiling a FORTRAN program, 2-1 
CONSTRUCT TDV Function task, 19-1 

error messages, 19-2 
Control-character facilities, 1-2.1 
Control records, SLIP, 5-4 
Conventions for TDV command, 1-8 
Conversion to XVM/RSX, 6-18 
CTRL/D, 3-6 
CTRL/Q, 6-3 
CTRL/T, 1-7 
CTRL/U, 1-9 



Editor, 4-1 

error messages, 4-3, 4-4 
Editing batch files, 5-1 
Editing disk-to-disk, 4-3 
END-OF-FILE, 5-14 
End-of-file, SLIP, 5-5 
Error codes for *FILE routine, 

5-15 
Error flags, MACRO Assembler, 3-7 
Error messages, 

CONSTRUCT, 19-2 

DECTAPE DIRECTORY LIST, 11-3 

DELETE FILE, 8-1 

DIRECTORY LIST, 10-3 

DISMOUNT, 17-2 

EDITOR, 4-3, 4-4 

FORTRAN, 2-5 

INSTALL, 13-3 

MACRO Assembler, 3-9 

MOUNT, 16-2 

NEW DIRECTORY, 12-2 

ODT, 22-10 

OTS, 2-15, 2-17 

QUEUE, 21-4 

REMOVE, 15-2 

RENAME FILE, 9-2 

REQUEST, 14-2 
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Error messages (cont.) 
SLIP, 5-14 
TDV, 7-5 
TKB, 6-19 

Errors, 

$SLIP control record, 5-15 
SLIP sequencing, 5-16 
TKB recoverable, 6-20 

Executive-mode option, 6-7 

External links, 6-14 

EXU.13, 6-13 



File creation date, 10-2 

*FILE errors, 5-14 

File name and extension, 10-2 

Pile name list, 6-13 

*FILE records, 5-4 

File size, 10-2 

*FILE specification, SLIP, 5-3 

File transfer, 7-3, 7-4 

FIN, TDV Function task, 7-2 

Floating-Point Processor (FPP) , 

2-1, 2-4 
F option, 7-3 
Form feeds, 7-3 
FORTRAN error messages, 2-5 
FORTRAN IV Compiler options, 

2-2 
FORTRAN line numbers, 5-10 
FORTRAN, other versions, 2-3 
FORTRAN program compilation, 

2-1 
FOU, TDV Function task, 7-2 
FPP system OTS error messages, 

2-17 
Free blocks, 11-1 
Function tasks, TDV, 1-2 



Historical system information, 
23-2 



Input/output (cont.) 

EDITOR, 4-2 

FORTRAN IV, 2-4 

INSTALL, TDV Function task, 13-2 

MACRO Assembler, 3-5, 3-6 

MOUNT, 16-1 

QUEUE, 21-3 

REMOVE, 15-1 

RENAME FILE, TDV Function task, 
9-2 

REQUEST, 14-1 

SLIP, 5-14 

STATUS, 23-1 

Task Builder, 6-4 

TDV function tasks, 7-3 
INSERT, 5-6, 5-7 
Insertion records, SLIP, 5-4 
INSTALL, TDV Function task, 13-1 

error messages, 13-1 
Internal links, 6-14 
Introduction, 1-1 
Invoking, 

CONSTRUCT, 19-1 

DECTAPE DIRECTORY LIST, 11-1 

DIRECTORY LIST, 10-1 

DISMOUNT, 17-1 

FIN, DEC, FOU, LIS and 
TYPE, 7-2 

FORTRAN IV Compiler, 2-1 

INSTALL, 13-1 

MACRO Assembler, 3-2 

MOUNT, 16-1 

NEW DECTAPE DIRECTORY 
LIST, 12-1 

ODT, 22-2 

QUEUE, 21-1 

REMOVE, 15-1 

REQUEST, 14-1 

SLIP, 5-2 

STATUS, 23-1 

Task Builder, 6-2 

Text Editor, 4-1 
I/O devices, 1-6 
lOPS ASCII mode, 7-3 
lOPS binary data mode, 7-3 



Image mode, 7-3 

Index register (XR) , 6-7 

Initialize FORTRAN I/O tables, 

2-4 
Input/output, 2-3 
CONSTRUCT, 19-1 
DECTAPE DIRECTORY LIST, TDV 

Function task, 11-2 
DELETE FILE, 8-1 
DIRECTORY LIST, TDV Function 

task, 10-2 
DSM, 17-1 



Library files, 6-13 

Library routines, 6-13 

Line-by-line mode editying, 4-1 

Linkages, 3-1 

LINK definitions, 6-14 

Links and structures description, 

6-13 
LIS, TDV Function task, 7-2 
List options. Task Builder, 6-4 
Lower-case characters, 1-10 
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LUN assignments, 
Editor, 4-2 
FORTRAN IV, 2-3 
MACRO Assembler, 3-5 
TDV function tasks, 1-4 



MACRO Assembler 

error flags, 3-7 

error messages, 3-9 

other versions, 3-6 
MACRO definitions file, 3-6 
MACRO program assembly, 3-1 
Magtape operation, 7-4 
Memory protection, 6-7 
MNT, TDV Function task, 16-1 

error messages, 16-1 
Monitoring task prograss, ODT, 

22-6 
Mounting a disk logically, 16-1 
Mount tape, 7-4 
MULTIACCESS, 1-1 

control-character facilities, 
1-2.1 

Monitor commands, 1-2.1 



Name task option, 6-8 
NEW DECTAPE DIRECTORY, TDV 
Function task, 12-1 
error messages, 12-2 
N option, 7-3 
No parity check, 7-3 



Object-Time System (OTS) 

library routines, 2-1 
ODT, 22-1 

commands, 22-2 

error messages, 22-10 

example, 22-6 

monitoring task progress, 22-6 

restrictions, 22-1 
Optional characters, 1-9 
Optional itmes, 1-10 
Options, 

Assembler , 3-2 

SLIP, 5-3 

$SLIP, 5-2 
OTS error messages, 2-15 
OTS error messages in FPP 

systems, 2-17 
OTS output, 2-4 
Overlay structure description, 
6-15 



Page eject, 7-4 
Page-mode option, 6-7 
Parameter input, 

MACRO assembler, 3-6 
Partition Block Description 

List (PBDL) , 6-9 
Partition description, 6-9 
Partition size, 4-3, 6-7, 6-8 

6-9 
Parity error message suppression, 

7-3 
PASSl, PASS2, PASS3, 3-1 
PAUSE statements, 2-4 
Pool of Empty Nodes, 6-7 
Priority default, 6-8 
PUP (Peripheral Utility Program) , 

1-1 



QUEUE, TDV Function task, 21-1 
error messages, 21-3 



Random-access information, 10-2 
Recoverable TKB errors, 6-20 
REMOVE, TDV Function task, 15-1 

error messages, 15-2 
RENAME FILE, TDV Function 
task, 9-1 

error messages, 9-2 
REPLACE, 5-8 
REPLACE WITH FILE, 5-9 
REQUEST, TDV Function task, 14-1 

error messages, 14-2 
Resident code definition, 6-13 
Resident TDV Dispatcher, 1-7 
Rubout, 1-9 



SEARCH AND INSERT, 5-10, 5-11 
SEARCH AND REPLACE, 5-12 
SEARCH AND REPLACE WITH FILE, 5-13 
Sequential files transfer, 7-1 
Shared address space (SAS) , 6-10, 
6-11 

external (ESAS) , 6-11 

internal (ISAS) , 6-11 
Shared COMMON block description, 

6-10, 6-11 
SIZE command, 4-3 
SLIP, 5-1 

command syntax errors, 5-16 

control records, 5-4 

editing demonstration, 5-16 

error messages, 5-14 

options, 5-3 

sequencing errors, 5-16 
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$SLIP control record errors, 5-13 

$SLIP options, 5-2 

Source programs, 3-1 

Space, 1-10 

Space character, 7-2 

Square brackets ([]), 1-10 

Starting block number, 10-2 

STATUS, TDV Function task, 23-1 

STOP Statements, 2-4 

Structures description, 6-13 

Symbol table, 3-1 

System blocks, 11-1 

System COMMON blocks description, 

6-10 
System library, 6-13 
System status, 23-1 



Task development (TDV) , 1-1 

Task name, 6-8 

Task storage on disk, 19-1 

TDV command conventions, 1-9 

TDV error messages, 7-5 

TDV function tasks, 1-2, 1-9 

TDV/system communication, 1-8 

(terminator) , 1-10 
Terminators, command string, 1-9 
Text-editing source code, 4-1 
Text Editor, other versions, 4-3 
TKB errors, 6-19 

recoverable, 6-20 

unrecoverable, 6-21 
Transferred files, 7-3 
Truncation mark, 10-2 
TYPE, TDV Function task, 7-1 



Table Initialization, 2-4 
Task breakpoint, 22-1 
TASK BUILDER, 6-1 

input/output, 6-4 

options, 6-5 
Task building, 

CONSTRUCT, 19-1 

DELETE FILE, 8-1 

DECTAPE DIRECTORY LIST, 11-2 

DIRECTORY LIST, 10-2 

DISMOUNT, 17-1 

FILE INPUT, 7-3 

INSTALL, 13-1 

MOUNT, 16-1 

NEW DECTAPE DIRECTORY, 12-1 

QUEUE, 21-3 

REMOVE, 15-1 

RENAME FILE, 9-2 

REQUEST, 14-1 

STATUS, 23-1 



UFD, 16-1 

Unrecoverble TKB errors, 6-21 

Upper-case characters, 1-10 

User files, 11-1 

User-mode option, 6-7 



Virtual partition size, 6-10 



XFRCMD system directive, 1-9 
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